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PART VI - EXERCISES . 



FOREWORD 



This report contains the results of the second 18 ninths (December 15* 
1968 - June 30* 1970) of effort toward developing an Information Pro- 
cessing Laboratory for research and education in library science. The 
work was supported by a grant ( OEG— X— 7“07i085“^-286) from the Bureau of 
Research of the Office of Education* U.S* Department of Healths 
Education, and Welfare and also by the University of California. The 
principal investigator was M*E* Mar on * Professor of Librari anship . 

Ibis report is being issued as six separate volumes by the Institute 
of Library Research* University of California* Berkeley, They are: 

* Maron* M S E» and Don Sherman* et al. An Information Processing 

Laboratory for Education and Research in Library Science: Phase 2 , 

Contents — Introduction and Overview; Problems of Library 
Science; Facility Development; Operational Experience. 

6 Mignon* Edmond and Irene L. Travis. LABSEARCH: ILR Associative 

Search System Terminal Users 1 Manual . 

Contents — Basic Operating Instructions; Commands; Scoring 
Measures of Association; Subject Authority List. 

* Meredith* Joseph C, Reference Search System (REFSEARCH) Users 1 Manual 

Contents --Rationale and Description; Definitions; Index and 
Coding Key; Retrieval Procedures; Examples. 

’ Silver* Steven S. and Joseph C. Meredith. DISCUS Interactive 
System Users f Manual , 

Contents — Basic On-Line Interchange; DISCUS Operations; 
Programming in DISCUS; Concise DISCUS Specifications; 

System Author Mode; Exercises. 

4 Smith, Stephen F . and William Harr el son. TM3; A Terminal Monitor 
System for Information Processing . 

Contents — Part Is Users 1 Guide - A Guide to Writing Programs 

for TMS 

Part II 1 Internals Guide - A Program Logic Manual 
for the Terminal Monitor System 

* Aiyer, Arjun K. The CIMARQN System: Modular Programs for the 

Organization and Search of Large Files , 



Contents — -Data Base Selection; Entering Search Requests; Search 
Results; Record Retrieval Controls; Data Base Generation. 



Because of the joint support provided by the File Organization Project 
( OEG-I-7-O7IO83-5068 ) f°r the development of DISCUS and of TMS, the volumes 
concerned with these programs are included as part of the final report for 
both projects. Also* the Cl MARON System* whose development was supported by 
the File Organization Project* has been incorporated into the Laboratory 
operation and therefore * in order to provide a balanced view of the total 
facility obtained* that volume is included as part of this Laboratory pro- 
ject report. (See Shoffner, R.M., et al . , The Organization and Search of 
-^^^^ .ographic Records in On-Line Computer Systems: Project Summary * ) 
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INTRODUCTION 



DEFINITION DISCUS is an interpretive man-computer 

interface system, currently implemented 
as a conversational OAI language* It is 
programmed entirely in assembly language, for the IBM 360 
series , 



BACKGROUND In July of 1967 the Institute of Library 

Research initiated Project No, 7-1085 , 

An Information Processing Laboratory for 
Education and Research in Library Science s supported under Office 
of Education grant No, OEG-1-7^071085-1+286 , with contributory 
support by the University of California- In the design of such 
a laboratory, one of the important aspects to be investigated 
was the suitability of Computer Assisted Instruction (CAl) as 
a means of presenting certain types of library science materials 
to students in a graduate School of Librarianship . We needed 
to know what prior preparation of such materials would be re- 
quired, what would be the programming problems in developing 
an on-line dialogue for instructional purposes, and how best 
to implement this kind of facility for graduate studies*. 

These requirements led to the actual writing and program- 
ming of a substantial amount of instructional material in the 
CAI medium, and to Its implementation in the Information Pro- 
cessing Laboratory - using first teletype and typewriter termi- 
nals, and subsequently cathode ray tube (CRT) terminals acquired 
under a University grant for innovative projects in education. 
When our research on the Information Processing Labora- 
tory first began, we investigated the then existing 
languages of the type known as lf selected character-string 



match languages I.e., those capable of scanning free input 
for specified key elements, then acting on success or failure 
in finding these elements as instructional branching determin- 
ators . Among those considered, a new language under develop- 
ment in the Office of Information Systems , University of 
California at San Francisco, called PILOT^, appeared to be the 
most promising, and accordingly it was chosen as the new lan- 
guage in which we would encode our first courses of instruction* 
However, the choice was necessarily provisional, since PILOT 
itself was still under development , and there was no guarantee 
that it would stabilize in exactly the form which would be best 
for the system envisaged for the Information Processing 
Laboratory , 

During 1968 and most of 1969 ? most of our CAI materials 
were programmed in PILOT, and were run under the PILOT system 
operating on an IBM 360/50 at the San Francisco campus Computing 
Center, with linkage by commercial grade telephone lines and 
acoustic couplers to our mechanical terminals in the Laboratory, 
This arrangement was occasioned by the fact PILOT requires con- 
siderably more core memory than was available to us through the 
IBM 360 /Uo system serving the other needs of the Information 
Processing Laboratory , sited on the Berkeley campus. At the 
same time it demonstrated the feasibility of such an operation 
conducted at a remote distance from the central processing unit . 

With the acquisition of the CRT system as the primary 
terminal hardware for the Laboratory, the need for CRT-compatible 
software became controlling. Since PILOT does not provide this 
kind of interface, it was necessary for us either to try to write 
one or to adapt another language which already incorporated this 
feature. The latter appeared to be the more feasible course, 
especially in view of the problem of core requirements raised 
by continued use of PILOT. 



*Karpinski , R . , et al, PILOT. . , . <2 aonversationa l language - 
User Guide, Office of Information Services, University of Cali- 
fornia Medical Center, San Francisco, California. 12/1/68. 
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Meanwhile s the Institute of Library Research at the University 
of California at Los Angeles had generated certain papers dealing 
with LYRIC 5 the CAI language developed by Gloria M. and 
Leonard C . Silvern. 4 * In the fall of 1968 , Steven S. Silver 
(Staff 3 Institute of Library Research, UCLA.) undertook to 
examine the feasibility of adapting LYRIC to our needs. However, 
the problem of making the necessary changes proved more formidable 
than that of writing a new language from the beginning, and in 
January, 1969 , it was decided that we should proceed on the latter 
basis. We were aware, of course, that there is much to be said 
in favor of standardization of CAI languages, but felt that in 
the context of the kind of research we were performing, a new de- 
parture from existing forms was justified. It now appears that 
much additional research and development work remains to be 
done before a complete spectrum of CAI language characteristics 
and capabilities will be available, and that standardisation should 
be based on such a spectrum rather than on an attempt to make all 
programs look alike. 

The features to be embodied in the new language were the 
subject of numerous exchanges between Institute staff at Berkeley 
and Los Angeles, and the version finally decided on was specified 
on March 2 U, 1969 . These specifications followed the dicta that 
the system; 

(1) accommodate natural language input 



^Described in Computer-assisted instruction : specifications 

for CAI programs and programmers ^ by Gloria M. Silvern and 
Leonard C . Silvern, Proceedings of the 21 st Annual Conference of 
the Association for Computing Machinery, ACM Fubl. P-66 
(Thompson Book Co,, Washington, D.C. , 1966) 1 . 57 - 65 * 

Three of the papers referred to are limited distribution 
items- The fourth, A Description of LYRIC , a language for i^emote 
instruction by computer , by Steven S. Silver, appears as Appendix III 
in the final report on Project No, 7 ^ 1083 , Grant No* OEG- 1 - 7 — 
071083-6068, A Study of the Organization and Search of Bibliographic 
Raidings Records in On-line Computer Systems: Phase J, by 

Jay Cunningham, Will Schieber, and Ralph Shoffner, Institute of 
Library Research, University of California, Berkeley, California, 
March, 1969. 
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(2) maintain individual student data 

(3) restart individual students at the appropriate 
loeation § following a period of sign-off 

(k) operate under a multi-course , multi -terminal time 
sharing system 

(5) provide interface with CRT terminals 

(6) use as little core memory as possibles both in 
compiling and in execution 

Owing to the fact that a considerable amount of actual pro- 
gramming had been carried out prior to the final specification, 
it was possible to implement the new language for operational 
testing in May, 1 9&9 . In July, 1969, it was implemented at both 
the Berkeley and the UCLA campuses under the name of "DISCUS'*. Since 
that time, it has been undergoing continuous testing * evaluation * 
and revision. We now feel that it is sufficiently reliable and 
effective to justify its release for general use, 

DOCUMENTATION Complete documentation is available for 

prospective users of DISCUS, at cost, and 
with the understanding that suitable 
credits will be accorded to the Office of Education, Department 
of Health, Education, and Welfare for their support, and to the 
Institute of Library Research, University of C al ifornia * 

USERS 1 MANUAL Since there are two kinds of users to 

CONVENTIONS 

be considered, one concerned with the pro- 
gramming and implementation of materials 
in the system and the other with actual consummation of dia- 
logue at the terminal, we have adopted the following convention 
for the purposes of this manuals 

By USER is meant the author, instructor, or coder using 
the DISCUS system to develop instructional or 
other dialogue materials . 

By STUDENT is meant a person using a CRT terminal, inter^ 

acting with the system, (It should be understood, 
however, that the system is not necessarily limited 



to educational uses.) Note also that the USER 
(i.e., author) must use the system as does a 
STUDENT in order to prepare and debug instructional 
programs . 



A glossary of technical terms as they are used in this manual 
is provided in Part IV (CONCISE DISCUS SPECIFICATIONS). 

Where necessary to draw attention to one or more blanks in 
examples given in the text where their presence might be overlooked, 
they are represented by the letter "b" with hyphen over-strike, 
thus : 



as that in which it was written - as an interweaving of needs 
and purposes, of explanation and speculation, of rules, examples, 
warnings, and invitations. One should not feel uneasy in exploring 
this material in seemingly random fashion, nor too exasperated when 
he finds it necessary to retrace earlier steps* 

What we seek is a construct in the ancient sense of a piling 
up, a heaping together of elements which will in due course com- 
bine themselves in a manifest pattern. The functional relation- 
ships of the various pieces of the system cannot be well understood 
until something (not necessarily everything) is known about each. 
Until a concept of tl^ese relationships is achieved, the pieces 
themselves will have little meaning. 

The manual is organized in six parts, as follows: 

I. THE BASIC ON-LINE INTERCHANGE 



b = blank. 



ORGANIZATION 



It is not intended that this manual be read 
in strict page sequence. It should he 
read and studied in much the same way 



This part is intended to introduce the general idea of 
CAI programming, and to demonstrate the operation 
of three of the standard DISCUS commands. 



- 5 - 
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II. 



DISCUS OPERATIONS 



An explanation of the several DISCUS statements , and 
a discussion of the decision process, block structures, 
and variables. 

III. PROGRAMMING IN DISCUS 

Discussion of the role of the programmer vis ^a— vis 
the author /instructor . Technical considerations 
bearing on the design of CAI routines • Examples of 
useful subroutines. Advanced DISCUS programming. 

IV. CONCISE DISCUS SPECIFICATIONS 

Definitions and specifications. 

V. SYSTEM AUTHOR MODE 

Description of the program debugging facilities provided 
by the DISCUS language. 

VI. EXERCISES 

Six series of exercises supplementing Parts II and III. 
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PART I - THE BASIC ON-LINE INTERCHANGE 



LANGUAGE The kind of programming we will he 

dealing with is generally teiroed "high 
level j ,f in that it rises atop a sub- 
structure of service routines prescribed in great detail , rou- 
tines which we can rely upon without worrying about how they 
do the things they do. Theoretically, the highest level of 
programming language would be ordinary written communication, 
as if we were to tell the computer, in so many words, "I want 
you to program yourself to discuss counterpoint," or "How are 
you feeling today?" Of course at such a level, or any other 
level above that of detailed bit-manipulation, one does not 
really communicate with a computer, but with another person, 
one who has - we hope - foreseen at least part of our needs and 
has provided a program to accommodate them. 

Unfortunately, the more elaborate the structure, the more 
costly becomes the effort of maintaining verbal or near-verbal 

i 

communication through the computer* Simplicity at the top can 
mean ghastly complications near the bottom, all of which exact 
a price in terms of computer resources, 

DISCUS tries to cut through some of these complications by 
dealing with the computer r s operating system in quite funda- 
mental terms rather than through the intermediation of one of 
the medium- or high-level languages such as FORTRAN, SNQBOL, or 
PL/l . This accounts for DISCUS 1 speed and economy, as well as 
for the fact that not everything is made simple and easy for 
the user (i.e, , the programmer or encoder). In order to program 
properly in DISCUS - that is, to write conversational sequences 
of real versatility and power - the user must be adept with a 
number of highly specialized tools in various combinations. 
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rather than with a number of all-purpose tools , 



APPROACH In trying to decide how to present a 

system which needs to he seen in its 
entirety in order to he perceived as a 
system at all 5 we have concluded that a very general approach 
will he well worth the risk of a tew initial misconceptions which 
will he readily corrected in subsequent portions of the Manual. 

THE NATURE OF In order to establish an "interactive" 

"INTERACTION" 

situation 3 the programmer wants to force 
the computer to respond in a certain way 
to stimuli coming to it from some outside source — in our case 
from a CRT (cathode-ray tube) terminal. Basically the stimulus 
will always he a button-push , such as the user pressing (or 
thumping, if he likes) a key marked "attention ," or "send," or 
"interrupt 5 " or "carriage return". This act is like prodding a 
dumb animal with a stick. One expects a response of some kind 
unless the brute is very sick indeed. Usually the prod means 
"Hey , look what I wrote for you on my keyboard!" 

The computer looks , 

Its program tells it to react in a certain way to what it 
sees, depending on what that happens to be. 

It reacts, usually by putting together some kind of message 
®^d flipping it to a slow— footed retainer for inscribing on the 
face of the cathode-ray tube screen at the terminal. If we con- 
verted microseconds to a more comprehensible scale, we might say 
that the computer handed the message to a stone-carver who only 
worked Tuesdays - but that would be all right, since the terminal 
user wouldn't be heard from again for about a year anyway. 

It is customary to represent a dialogue between the computer 
and the individual as beginning with the computer, but this is in- 
accurate and can be quite misleading* The computer always has to be 
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Viewed in 



prodded, even before it will say "Sign in, please* ** 
this light, every action of the computer is a reaction . The human 
is always the protagonist, even though at times he may feel quite 
otherwise. 

The business of the CAI programmer is to equip the computer 
with adequate instructions to permit it to cope in some reason- 
able way with questions, commands * and statements expressed in 
ways that are human and therefore subtle, unpredictable, and messy. 



THREE DISCUS TOOLS In order to demonstrate the basic mechan- 

ism, we now provide the user with three 
basic tools with which he can simulate this 
relationship* With these tools he can even write a primitive DISCUS 
program: 

A codeword - ANSWER meaning "At this point in the program 

the human types some thing " 



A codeword - SCAN meaning "Try to recognize , in the 

answer ^ something speci- 
fied here" 

A codeword - WRITE meaning "Write on the GET screen 

whatever is specified 
here " 



SCAN and WRITE always refer to something specified by the coder: 



SCAN 



GREEN 



WRITE 



CORRECT 



ANSWER merely receives an unpredictable input typed by the student: 



ANSWER 



(?) 
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Observe the semicolons associated with each of the three code- 
words , They mark the end of that particular piece of coding, 
or statement. In other words , they "delimit the statement," 

There are several additional codewords in the DISCUS system, 
but these three will suffice for the moment. Suppose we arrange 
them in a circle, to show the basic action-reaction cycle. 




The computer ("central processing unit") does all its work 
in the shaded part of the diagram, in the space of, say, 1/1000 
second. The solid line represents the stone carver at work, 
hacking out the display at the rate of 250 characters per second. 
The unshaded part represents the student's reaction, occupying 
10, 15, 30 seconds or more, , .however long it takes him to read 
what has been written for him on the screen, to type in something 
new, and to push the "send" button. 



- 10 - 
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Proportioned according to time, the diagram would look 
like this: 
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THE KINDLY 

PROFESSOR 

ROUTINE 



e'-'U: 






Q> 




Computer processing 
contentedly alone 



Yea , young man? ; ^ 



ANSWER j i*m here for ay physios lesson* 




C 

j_WBITE , Well, veil. What do you want to knew about physios?; 




WRITE j Sorry | py Ecology clasp ig too full already.; 

‘ ~ * ■ % 



(New I can forget about 
his problem for a while) 




and so on 



3 

ERIC 



? 



Another way to represent the process Is with the coded 
statements themselves: 




represents the point where the "send" push or prod or 
is administered, 

(S) represents the point where the computer turns to other 
duties , 

There is virtually no limit to the number of SCMs and 
WRITEs that can be programmed to follow a "send" signal: 




Each of the four SCANs above could look for something different in 
the answer, and each of the WRITEs might be suppressed if the SCAN 
preceding it failed to find that something. In that little word "if" 
we become involved in the decision process , represented in the cartoon 
on page 12 by the inevitable diamond. 



O 
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Below are some blank statements, arranged so that the decision 
process can be indicated by line number. The reader is invited 
to write a short program in DISCUS at this point. 



Jot down a short question:. 



Nov 



fill in the blanks leaving line(T)(student input) 



until last: 


© 


ANSWER^ 


© 


SCAN _ 




WRITE - 




SCAN 


© 


WRITE 


© 


SCAN 



© WRITE 
SCAN 



© WRITE 
© SCAN 



11) WRITE 

12) WRITE 



Go to 



Go to 



»; Go to 



go go 



Go to 



If yes s go to_ 
If no, go to 



If yes* go to_ 
If no, go to 



I f y cs 9 go t o 
If ru . f go to 



If yes * go to_ 
If no 9 go to 



If yes* go tq_ 
If no, go c: ^ 



lj) ANSWER — (next cycle) 



Later ve shall Investigate the additional codewords for accomplish- 
ing the items on the right hand side of the page, but for the pre- 
send purposes ve can vaive this requirement* 



O 

ERIC 
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There is no vay in which we can comment on your first 
piece of DISCUS programming, but it might look like something 
like this: 



Question: (from a previous WRITE) Where is Rome? 



© 

© 


■ ANSWER 
SCAN 


© 

© 


WHITE 

SCAN 


© 


WRITE 


© 


SCAN 


© 


WRITE 


© 


SCAN 


© 


WRITE 


(io) 


SCAN 




WRITE 


© 


WRITE 




ANSWER 



I tdtij 



If yes 5 go to 3 
If no, go to 4 



Correct 



Go to 12 ; 



Georgia 



If yes ? go to 
If no, go to 6 



I mean the original \ Go to 1 ; 

Rome ; 

Europe ; 



What aountru in 



If yes s go to JF^ 
If no f go to 8 



Go to 1 



Europe 



Don 9 1 know 



; if yes * go to 

If no, go to 10 

You really should ; Go to 1 ; 

Asia \ If yes 5 go to 11 

If no, go to 12 

Hgx'dlu Go to 12 ; 

It r s in Italy , Where is Paris? * 



Note that in three cases the program doubles back to the 
original ANSWER statement * to give the user a chance to try a 
different reply to the same question. The ability to perforin 
such recursion is indispensable in CAI. 



O 
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THE DISCUS SYSTEM 



A "CAI system" comprises all the hardware 
and software dedicated to the specific 
purpose of computer-assisted instructions 
plus certain hardware and software customarily shared with other 
systems in the same computer center. The computer itself is a 
prime example of shared hardware. The computer's own operating 
system (in this case IBM’s 05/360) is a good example of shared 
software . 

Peripheral equipments such as disc storage units, may be shared 
(i,e*s their capacity allocated either on a physical location basis 
or on a real time basis) or they may be dedicated to a single sys- 
tem or use* 

The services of control and auxiliary software, such as a 
time-sharing monitor, may also be shared between systems. 

Although DISCUS can be spoken of as a CAI "language/' it should 
be thought of more as the dedicated software components of a 
CAI system . Only after it has been implemented in the Mwe, and 
actually "resides" in a computer, is the system complete end 
ready to operate. 

COMPILATION AN D The system must be capable of two distinct 

EXECUTION 

ana separate operations: First , it must 

be able to accept programs submitted to 
it for compilation into executable form, and to compile them - 
if in fact they are compilable according to the logic of the 
compiler. Normally an error in the source program submitted 
for compilation will not prevent compilation of the remainder 
of the program; only the faulty statement (and perhaps its 
associated statements) will be unexecutable . 

Second , it must be able to execute programs, once they have 
been accepted, compiled, and stored in its repertory, "Execution" 
takes place when a student at a remote terminal is actually on 
line. Execution does not change the system itself; it is simply 
a product of the system according to the instantaneous conditions 




22 

-IT- . 




existing within it. Execution is time-related, in the same way 
that the running of a movie film is time-related - the product 
in the latter case being a static image on a screen, at a single 
instant , or a moving image in a span of several instants* 

OPERATIONAL Four distinct operations are involved in 

PROCEDURES ^ n ^ , 

the realisation of the two basic functions 

described on the preceding page: 

1, Two blocks of code - the DISCUS COMPILER and the DISCUS 
EXECUTOR - are read, assimilated, and stored by the computer - 
These two blocks or modules are shown in the adjoining diagram* 

2* One or more SOURCE programs, consisting of data either in the 
form of tape or punched cards encoded according to the DISCUS 
rules, is submitted to the computer. This can be done at any time - 
minutes or months after the DISCUS COMPILER and EffiCUTOR have been 
successfully established. 

3. Whenever a SOURCE program is submitted, the DISCUS COMPILER 
attempts to compile it ^ that is, to arrange and store it in exe- 
cutable form. It also causes a complete listing of the compiled 
version of the program, called DISCUS OBJECT, to be printed. 

This listing shows the numbers that have been assigned by the 
COMPILER to individual statements , the condition code levels at 
which they will be presumed to operate, and the place in disc 
storage where each is stored away* It also includes a list of 
the labels attached to certain statements, showing where and how 
they have been referred to in the program. It also furnishes an 
indication of some types of coding errors* (A page of object 
listing, reduced to k3%* is shown on page 20.) 

h. The program submitted as SOURCE, having been compiled to produce 
OBJECT code, can now be executed, subject to any malfunctions 
which might be encountered due to the above mentioned errors. A 
student activates a remote console, signs in, calls up the pro- 
gram by name or number, and he is off and running- This is the EXECUTION 
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phase. In a time-sharing system, execution can be going on in 
several different parts of the OBJECT MODULE simultaneously, or 
at least switching back and forth so rapidly that it seems simul- 
taneous to several individuals using the system at the same time. 



STUDENT DATA SITS For each terminal in use, a portion of 

the computer’s disc storage must be set 
aside for keeping a record of where exe- 
cution is at any particular moment, for that particular terminal. 

It must also contain records pertaining to that user’s entire 
terminal session: various scores and tallies, saved responses, 

etc. This reserved section is called a "student data set," 

If the system permits users to sign off and to sign back on 
at a later time without having to begin all over again, it must 
keep a record of the "restart" location, plus all the scores and 
tallies left over from the previous session. Under this arrange- 
ment the student data set is stored away on disc during the time 
he is away from the terminal* 

The general arrangements for "start" and "restart" are touched 
upon in Part IV, but the actual implementation will vary from in- 
stallation to installation according to the design of the local 
monitor system. 

REVISION An existing OBJECT MODULI can be revised, 

or "updated," by submitting a revised SOURCE 
program to the COMPILER. In the course of 
recompiling this code, the COMPILER will obliterate the pre-existing 
OBJECT MODULE, unless a different area of disc storage is used for 
the new material. If the original SOURCE is available to the system 
on tape or disc, revision can be accomplished by using one of the 
utility programs provided by the IBM 360 Operating System, This 
permits changing certain card images recorded on the tape or disc, 
provided they have been numbered sequentially the first place, 
then ordering the revised tape to be read (as SOURCE) into the system* 
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OBJECT CODE LISTING (Reduced) 
Lines 698-7^9 = one small frame. 
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PART II - DISCUS OPERATIONS 



OPERATION CODES A list of the several DISCUS OPCODES 

which govern execution of program 
statements follows i 



Long form 


Short form 


See page 


WRITE 


W 


22 


WRITE (NF) 


w(nf) 


30 


WRITE (ND) 


W(ND) 


31 


ANSWER 


A 


3** 


ANSWER (NF) 


a(nf) 


39 


SCAN 


SC 


1+0 


DEFINE (A) 


D(A) 


56 


DEFINE (C) 


D(C) 


56 


SET 


S 


57 


TEST 


T 


62 


MATCH 


M 


68 


FAIL 


F 


68 


END 


E 


68 


JUMP 


J 


69 


BLOCK 


B 


77 


USE 


U 


77 


FRAME 


FR 


79 


NOTE 


N 


81+ 



There is no difference in operation "between the long and 
short forms of OPCODE. Until one has become thoroughly 
habituated to working with DISCUS, the long form is rieom- 
mended, because it makes printed listing of compiled pro- 
grams somewhat easier to read. 

The DISCUS compiler automatically assumes that any 
of the above forms is in fact an OPCODE if it is preceded by 

a colon (marking the end of a preceding DISCUS label), 
with any number of intervening blanks ; 
a semicolon (marking the end of a preceding DISCUS 
statement), with ary number of intervening 
blanks ; 

nothing at all (i. e,, the beginning of the program), 
and is followed by a blank. No special punctuation or other 
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character is required to indicate its status as an OPCOIDE, 
and there is no danger of a properly positioned OPCOJDE being 
interpreted as a label, or as text to be displayed: 

WRITE RIGHT j 

will cause 



RIGHT 

to appear on the CRT screen, provided the last non-blank character 
preceding "WRITE" (if any) is a delimiter (i,e , 5 either a colon or 
a semicolon.) 



WRITE or W A CRT screen can be "written" in one of 

two ways : through execution of a pro- 

grammed WRITE statement by the computer, 
or by a student inputting characters at his terminal's keyboard. 

A typical display will consist of a block of programmed text, fol- 
lowed by an arrow or carat indicating the starting position of 
keyboard Input to come, and a cursor to indicate the position in 
which the next keyed character will appear. 

Before the terminal -user types any characters , the screen may 




After the terminal -user types characters, "but before he presses 
the "send" button, the screen might look like this: 




There are three forms of WRITE commands governing WRITE 
statements. Their form is independent of the purpose of 
the text to be written: any one of them can be used for 

conveying didactic text, for posing questions, or for res- 
ponding to terminal Input, No.t all WRITE statements coded 
by the programmer are actually displayed in a particular 
terminal session. They are used 3 elecilvely , depending 
entirely on the path which execution takes on that occasion, 

A simple WRITE or W writes the screen from the top, 
after erasing all previous display material. It continues 
until the end of the statement, or until the end of the screen 
is reached, whichever happens first. In the latter case, 
the overflow is saved until the terminal user presses his 
button. This action is treated as an impromptu 
WRITE command, the screen is erased, and the remainder of 
the WRITE statement's operand ( i . e . , the text subject to that 
WRITE command) is displayed, 

End-of~line formatting is automatically performed- that 
is, no word will be started that can't be finished on that 
same line. 



*0r other designated signal, e.g., "interrupt'’ or "attention, 
depending on the kind of terminal in use. 
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M 



Statement 



Examples 

WHITE ABSOLUTELY RIGHT!!? 



Result 



ABSOLUTELY RIGHT!! 



1 




Statement - WRITE THE INIQUITY OF OBLIVION BLINDLY 
SCATTERETH HER POPPY.; 

(Throughout this manual we use an "example 
screen" with a line-width of 27 characters , ) 

Result - 




A line break may be forced at any point, inside or outside 
of a word, by inserting a slash (/) in the text. The slash 
is not displayed. Thus: 





Statement 



WRITE AN ELEPHANT IS A/MARSUPIAL/MANMAL/MASTADON , 



Result 




Formatting within the line can be accomplished by inserting 
blanks immediately after the slash: 

Statement - WRITE AN ELEPHANT IS A/bbbbMARSUPIAL/ 
bbbbMAMMAL. /bbbbMASTADON . ; 



Result 




(Rote : the b symbol is used only for explication herein, when 

necessary to emphasize the presence of blanks. It Is never en- 
coded as such. In keypunching, the space bar actually specifies 
blanks, in WRITE text,) 
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The slash is a "reserved character 11 in DIBCUS* In a WRSE 
statement it always means ‘‘go to the beginning of the next line,, 
unlesg 

(a) it is identified a a literal^ by single quotes 
preceding and follom^o' it, or 

(b ) it is contained in a quoted variable (discussed 
on page 55 ).** 

Two slashes (//) mean "go to the beginning of the next line, 
then go to the beginning of the next line after that, " having 
the effect of a double space* Any number of blank lines may 
be created in this manner* 

Statement - WRITE HERE IS A TRUE 9 / 9 FALSE QUESTION//!'/ 

'2 LEAGUE ^ 1 1 '/' 2 MILES J 

Result - 

Automatic line 
break 

Forced line break 
and double space 

Delimiting semi* 
colon is not 
displayed 



The single quote Is also 
must be specified as a literal if one desires that It be written on 
the screen , but to do this we simply double it, rather than sur* 
rounding it with single quotes : Thus 1 f 5 not 111 . 




a reserved character. Like the slash 5 it 



^Definition given on p,117, 

**For the moment, these exceptions need not concern the reader. 

^ # *The DISCUS COMPILER always looks for pairs of single quotes. A 
good way of checking coding is to make sure that the total number 
of single quotes in a series of statements is an even number. The 
compiler will try to turn whole pages of source programming into 
a literal, following an odd-numbered single quote* 




State ment 



WRITE FELLINI” S 8 2 '/' 2 ; 



Res ult 




Three other reserved characters need to he considered: 

: ^ the colon s which normally acts as a label delimiter 

; - the semicolon, 11 tf ,f ?f statement 11 

11 - the double quote, which normally surrounds the label of 

a variable whose contents are to be used at that point. 

As with the slash, their special quality is suppressed by sur- 
rounding them with single quotes; they will then be displayed as 
literals . 



St atement 



WHITE DON 9 9 T TRUST YOUR MEMORY 9 ; 9 WRITE IT 
DOWN 9 : 9 /bbhh 9 " f LILLIOM 9 " ’ ~ MOLNARj 



Result 




If, in the example immediately preceding, the single quotes had 
been omitted from around the semicolon, it would have been treated 
by the DISCUS COMPILER as a statement delimiter: 



.32 

- 27 - r . 

..<?• . = 



Result - 



DON'T TRUST YOUR MEMORY 



Followed by — 




If the single quotes had bee:-, omitted from around the double quotes, 
the compiler would have searched fruitlessly for a variable called 
(Or if they had been omitted from around the colon, the 
compiler might try to treat DOWN as a label - but since DOWN is not 
immediately preceded by an active semicolon, the compiler would 
give a diagnostic message. 

It is possible to economise somewhat in the use of single 
quotes for suppressing the special nature of reserved characters, 
because everything enclosed within a pair of single quotes be- 
comes a literal. Thus both 
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Statement 



WRITE l'/ 9 2 9 : 9 2 ' : : f CUP' : 'QUART 



and 



Statement 



have the same 



Result 



WRITE 1 9 /2: 2: :CUP: 'QUART; 




Normal end-of-li ne formatting is not affected by the above device, 
even if a line break occurs within the string surrounded by single 
quotes s 




WRITE (NF) or W(NF) This OPCODE causes the operand which 

follows it to he displayed without 
end— of— line formatting. 

Statement - WRITE (NF) THE INIQUITY OF OBLIVION BLINDLY 
SCATTERETH HER POPPY.; 



Result 




All other conditions are the same as with plain WRITE. 
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WRITE (HD) or W(ND) 



This OPCODE causes its operand to be 
displayed immediately following the 
preceding WRITE operand, without first 
erasing the screen. If the last preceding write statement 
has carried a WRITE opcode, end-of— line formatting will continue. 

Statements - WRITE TEE INIQUITY OF OBLIVION BLINDLY 
SCATTERETH HER POPPYSEEDS.; 

WRITE (ND)b PLEASE IDENTIFY AUTHORSHIP 

AND TITLE.; 



Result 



Tfffi: INIQUITY OF OBLIVION 
BLINDLY SCATTERETH HER 

POPPYSEEDS * PLEASE 

IDENTIFY AUTHORSHIP AND 
TITLE * 



If the last preceding write statement used a WRITE (NF) 
opcode, the WRITE (ND) result will be unformatted* 



Statements - WRITE (NF) THE INIQUITY OF OBLIVION BLINDLY 
SCATTERETH HER POPPYSEEDS 

WRITE (ND) . * . . PLEASE IDENTIFY AUTHORSHIP 
AND TITLE 



Result 



THE INIQUITY OF OBLIVION BL 
XNBLY SCATTERETH HER POPPYS 

EEDS PLEASE IDENTIFY AU 

THORSHIP AND TITLE . 



\ 



The WRITE(ND) OPCODE is especially useful for displaying 
blocks of text simultaneously in smooth, consecutive format- 




It can also "be of service to the coder who undertakes the 
revision of a long statement already keypunched. Suppose 
an author or coder decides to remove a sentence from the 
middle of a 1000-character WHITE statement. If only the 
latter part of the statement is repunched , an unsightly gap 
in the text would occur, unless the sentence happened to be 
precisely 80 characters in length (which would allow him 
simply to remove the one card,) His alternative, afforded 
by the WRITE (ND) opcode, is to terminate the statement at 
the cut and turn the remainder into a WRITE (ND) statement. 
In miniature : 



Statement - WRITE OATS , CAULIFLOWER ; PEAS* BEANS , MD 



CABBAGE GROW j 



Result 




(Example continued on next page) 
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If we were simply to substitute blanks for CAULIFLOWER, the 
display would look like this: 




correctable by: 



Statements - WHITE OATS, ; 

WRITE (NFJ PEAS, BEANS, AND CABBAGE GROW . ; 




If WRITE (NB) text exceeds the remaining capacity of the screen, 
as much as can be displayed will be, and the remainder will be 
saved for display on the next screen* 

At this point it is suggested that the reader turn to the 
exercises in Fart VI (page lU) , 
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ANSWER or A When ANSWER or A is encountered during 

execution, the arrow or carat inviting 
input is added to the text of the last 
WRITE statement , and the computer goes into "wait state.” 
(Actually it is the ANSWER opcode which forces the preceding 
WRITE operand out of the display buffer and onto the screen, 
hut this is a technical point that need not concern us at 
the moment . ) 

While the computer is in the wait state, all processing is 
suspended, and in fact nothing the student types on the screen 
will be considered by the system until he presses the "send" 
button. When he does, the program causes the computer to read 
off the characters he has typed and to store them one by one in 
a special area of computer memory which the DISCUS system sets 
aside as an "answer field." If he has typed more than 250 char- 
acters before pressing "send," all the excess Is lost. 

The ANSWER statement may be labelled in order to provide 
an address to jump to during execution, but the label is never 
used to refer to the contents of the ANSWER field. These 
are called out and displayed, or transferred to other locations 
simply by referring to "ANSWER" . 



Statements - WRITE A SINGLE QUOTE (' ’) IS CALLED A (N) 

WHEN IT IS USED IN A CONTRACTION, j 



ANSWER; 



Suppose any incorrect answer is to be quoted back to the 
user, and in a particular case he has typed the word "con- 
tractor," (next page) 



-3b~ 



St at ement 



WRITE "ANSWER” ISN * r T THE EIGHT ANSWER. j 



Result 




(Example continued on next page) 
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or better yet 



Statement - WHITE NO, 9 99 9 "ANSWER” 9 " 9 ISN 9 f T THE RIGHT 
ANSWER. ; 

Result 




"ANSWER" causes only the current contents of the answer field 
to be displayed* In order to store an answer for future 
reference , it must be transferred to a labelled variable by 
means of a SET statement (page 57 ff*). 

Note that the ANSWER statement itself, in the example on the 
preceding page, needs no operand* This is usually the way 
it is encoded, but when the programmer wishes to supply 
elements of the answer in order to influence the student in 

i 

some way, he can do so by inserting them as operand in the 

ANSWER statement, thus: ■ 

Statements - WRITE WHAT ABOUT 9 "LIQUID” AND ” FLUID ”*?/; 

ANSWER THE TWO WORDS ARE ; 

WRITE DO YOU REALLY THINK THAT "ANSWER ” • 
(to be used if the answer is determined 

to be wrong. ) ■ \ 

j 

i 

j 
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Result 



Before student starts 
typing: 




After typing but before 
"send": 




After "send": 
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The foregoing device is useful in two different ways, (l) It 
permits giving hints outside of the basic instructional block, 
and these hints perform duty as re inforcers: 

Statement - W ONE OF THE MOST DREADFUL POEMS OF THE 
NINETEENTH CENTURY WAS WORDSWORTH ,r S ; 

A ' " T GOODY BLAKE AND; 



and fb 



W "ANSWER "'" 9 IS CORRECT. : 

(to be used if student answered ,f Harry Gill, 11 ) 

W NOj HE DIDN"T WRITE ANYTHING CALLED "ANSWER" I 
(to be used if he answered something else,) 



Results 







(2) It permits pre-structuring an answer in such a way that 
it can he quoted later with fair assurance of a grammatical 
fit . 

ANSWER(NF) or ACNE) A(NF) operates in exactly the same 

way as the basic ANSWER opcode , ex- 
cept that the answer is expected 
at the end of the last line of displayed WRITE characters * 
instead of at the beginning of the next line below and no 
carat appears : 




This permits more natural- looking displays where formulae 
or sentence-completion questions are involved. It does not s 
however, offer a means of positioning the carat within 
WRITE text, as might be desired in order to give realism to 
some types of fill-the-blank questions. A literal carat may 
be written in a WRITE statement but it will have no special 
significance to the succeeding ANSWER statement. 



SCAN or SC 



The SCAN opcode invokes an operation 
which is fundamental to any ,r character- 
string match" language, i.e,, one which 
can detect certain prescribed elements in a string of input. 

These elements may be single characters , whole words , phrases 5 
sentences, punctuation marks, numerals, etc, A measure of such 
a language is its ability to recognize non-conseeutive elements , 
particularly if they are in some order other than that in which 
they are listed in the SCAN operand; to re-examine input as many 
times as necessary in order to establish a certain profile; and 
to deal with negations, A CAI language which cannot recognize re- 
sponses outside of a limited format (such as a single button^push) 
is of a different type altogether. 

The basic scan statement in DISCUS consists of the SCAN opcode 
followed by an operand in which the coder enters those elements 
whose presence in, or absence from, student input is to be estab- 
lished, Thus 

SC WHITE ; 

working on input of 

BED WHITE AND BLUE 

will be satisfied, and a system condition code will be set to indi- 
cate the f act * The information is typically used to dictate what 
will happen next in the execution of the program. 

One way of visualizing the scan operation is to think of the 
operand as occupying a moving window, one which opens onto student 
text. It sweeps from left to right across the input string until 
it either encounters an uninsulated semicolon (signalling the end 
of the statement) or "sees" a combination of characters which match 
it exactly. 



would be scanned-for sequen- 

BLUE 
BLUE 
BLUE 
BLUE 

BLUE Match! 

BLUE 
BLUE 
BLUE 

Actually what happens in DISCUS is that student input* pre- 
ceded by a notation indicating its length* is stored in a field 
called "ANSWER" when the "interrupt" or "send page" key is pressed* 
The message is placed on a rack, as it were, where it can be ex- 
amined in detail by the program. Only the input is thus transferred* 
Neither the ANSWER opcode nor the end-of -statement semicolon is 
moved to the ANSWER field. 

The operand of a SCAN statement specifies the items to be 
looked for in the answer, and the order in which they will be 
checked. It is important that the DISCUS user understand how this 
takes place. What really happens when a SCAN statement is executed? 

Before launching into the discussion, it will be well to con- 
sider the definitions of "word" and "literal" as given in the 
Glossary : 

WORD A WORD is a string of characters that does 

not include imbedded blanks , special charac- 
ters, or symbols, and is surrounded by 
blanks, either explicit or implicit, WORDS 
used in SCAN statements constitute elements 
against which a user’s response may be compared, 

LITERAL A LITERAL is a string of characters , punctuation 

marks, symbols, numerals, or explicit blanks, 
not used in a special code sense. In order to 
be treated as a LITERAL, such a string must be 
surrounded by single quotation marks , (For use 
of these marks themselves as literals, see 
example, page 26 , ) Inclusion of a character in 
a LITERAL suppresses any special characteristic 
It may normally possess in the DISCUS system. 



For example , the operand WHITE 
tially as follows: 

\ RED WHfcTE AND 
AND 
AND 




AND 

BED WHITE~\ AND 
RED WHITE AND 
BED WHITE AND 
RED WRITE AND 
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A word is commonly recognized as_ a word s in written or print- 
ed communications , if it is preceded by one or more blanks and 
followed by one or more blanks or punctuation marks* Because this 
convention is almost universally accepted in the Western world } we 
are able to identify individual elements as elements quite rapidly, 
prior to interpreting them. Conceivably we could dispense with 
this service. For example, one is able to extract meaning from 

BREAKGLASSINCASEOFFIRE 

thanks to some impressive computations of which the human brain is 
capable. But it is much easier and faster to read (i.e., scan 
identify, recognise) the message given in conventional form: 

BREAK GLASS IN CASE OF FIRE 

Blanks really represent non- content-bearing breaks in the informa- 
tion stream, and although such breaks can be almost as useful to 
a computer as they are to humans , they are useful to it in a dif- 
ferent way, A computer deals with blanks as definite entities, 
not as just vague nothings on either side of something meaningful. 
Perhaps the best way of defining "WORD" acceptably for both com- 
puters and humans is to say that it is a blank- less element between 
two blanks . 



SCANNING FOR WORDS The DISCUS system carries out the follow- 

ing steps in scanning for a word specified 
in a SCAN operand: 

Step 1. The first word in the SCAN operand Is identified . 

Example: In SCAN THANE CANDOR; "THANE" is considered 

to be the first word, because it is the first 
element not containing a blank and not en- 
closed in single quotes. 

Step 2* The first word la moved to a location we refer to as "the 
window.” Enroute, it Is furnished with a beginning blank 
and an ending blank . 



SC THANE CAWDOR * 
feTHANEb 



"window 11 

j 
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IfeTHAHEbl 
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Step 3* The contents of the window are compared with the contents 
of the^ answer field, starting with the first string of 
equal length at the extreme left end of the ANSWER field , 
and moving one position at a time toward the right . 

Suppose the ANSWER field contains 



bTHE THANE OF CAWDORb 

and a length notation off to one side, 

(The "beginning and ending "blanks in the ANSWER field 
were added at the time student input was transferred 
from the terminal, ) 

The scan "begins. In the fifth position of the "window" , 
t-he contents of the window match exactly that which it 
sees in the ANSWER field. 



bTHE THANE OF CAWDORb 

■"n'l teTHAMEbl -* 



If the ANSWER field ha.d contained, instead, bTHE TRAIN OF 
CAWDORte, the comparison would have proceeded all the way to the 
end of the ANSWER field, and a failure would have resulted for 
the SCAN operand in question. 

Since we found a match on the first word in the example , we 
proceed with the next step, which is the same as Step 1 above, 
using the second word in the SCAN operand. Again, the word is 
furnished with a "blank fore and aft , and a notation is made that 
we are in fact dealing with a word. However, this time the com- 
parison begins not at the beginning of the ANSWER field, but at 
the ending blank of the previous successful comparison: 

i THE THANE OF CAWDORb 



A (match) 






B_ (starting position) \bCAWBORh\ 

0 (match) bVAWbORk I 



Note that the ending blank in A overlaps the beginning blank in B, 
This overlap can occur only if the string being compared is a word, 
If the ANSWER field had contained simply feTHANE CAWDORb both the 
first comparison and the second comparison would have succeeded, 
in their first positions, even though both seem to take advantage 
of the same blank in the ANSWER field. 



4 
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SCANNING FOR The DISCUS system carries out the following 

LITERALS 

’ steps in scanning for literals specified in 

a scan operand: 



Step 1. The first literal in the SCAN operand Is identified . 

Example. In SCAN f PAR r 'VER ' ; , 'FAR' is considered 
to be the first literal, because it is the 
first element enclosed in single quotes. 



Step 2. The material enclosed between the single quotes (but not 
the quotes themselves) is moved to the window . It is NOT 
furnished with beginning and ending blanks - 

SC ' PAR * 'VER'2 

s. 

PAR 




Step 3. The contents of the window a re compared with the contents 
of the ANSWER field . 

(Assume ANSWER field contains ) 

bPARROT FEVERb 

\par\ 

Match is obtained in the second position from the left. 



Step 4, 



Repea ts Step 1 (et seq . ) except that the comparison begins, 
with the second literal , a t the precise boundary of the 
first . 



b^ARR OT 



PAR 



VER 



FEVERb 

( i 
I | 



1 f 

r \ 




It is immaterial, in scanning for literals, whether the 
matching characters occur in the ANSWER field as word beginnings, 
word middles, or word ends. By the same token, literals may over- 
lap more than one word in the ANSWER field; i.e. , may include blanks, 
specified punctuation marks, etc.. Thus 



SC 'GT. BRIT.— HISTORY— 19TH CENTURY '• 
will match the following ANSWER field: 

I THINK IT SHOULD BE GT. BRIT. — HISTORY_ — 1QTH CENTURY_ . 
It will not match a variant such as 



I THINK IT SHOULD BE GT. BRIT — HISTORY — 79TH CENTURY. 



Such a SCAN statement is of course very rigid, whereas 



SC 'PAR' 'VER'i 

is quite the opposite, matching such things as "PARROT FEVER " , 

"PARLEY FOREVER", "SPARE EVERY TREE", "I'VE PARTED FROM VERONICA, 
etc . 

We can conclude that literals do not , in themselves , make 
the SCAN operation any more rigid than do words , provided they 
are of limited length and provided they avoid specifying punctu- 
ation marks and internal blanks , 



SCANNING FOR WORDS Although word elements and literal ele- 

ANB LITERALS INTER- 
MIXED ments in a SCAN operand are processed 

somewhat differently, there is nothing 

to prevent both types being used together in any combination that 

best suits the programmer ' s objective. For example, suppose he 

wants to find out if student input contains the words 

BON HOMME RICHARD 
or 

BONHOMME RICHARD (either version being 

acceptable ) 

In such a case SC 9 BON 9 ' HQmE 9 RICHARD j would turn the trick. 
Or suppose he wanted to detect the name 

DIONYSUS OF HALICARNASSUS 

without being fussy about the spelling * He could specify 
SC ' DIO 9 f US ' OF 9 HAL 9 9 SUS 

Note that by including blanks in the literals, the programmer effec 
tively specifies their position as word-beginnings or word-ends. 

He could have specified middles: 

SC f ON Y ' OF 9 CAR 9 j 

but with some loss of precision, in this particular case. 

In both of the foregoing examples, the SCAN elements are pro- 
cessed in the order in which they appear, regardless of whether 
they are words or literals. 



PUNCTUATION MARKS 
AND SPECIAL CHAR- 
ACTERS 



‘blanks * 



Before student input is placed in the 
ANSWER field, the punctuation marks 

are replaced with 



I QUIT!!!!! 
DON'T 



becomes I QUIT 
becomes 12 3 

remains DON r T 



If a particular punctuation mark or special character has, 
in the coding, been specified as a SCAN literal , the program 
will go back and restore it to the ANSWER field, if in fact it 
was typed by the student. 

It should be emphasized that none of the conventions for 
use of single quotes, double quotes, colons, slashes, or semi- 
colons which apply to encoded SCAN or WHITE statements affect 
the student's use of these marks in his input. For example, 
he doesn't need to type DON''! in order to have it recognized as 
DON'T. 



ADDITIONAL EXAMPLES Let us see how a scan operation involving 

more complicated strings would work. 
Suppose we want to scan for Don't go; stay 
We would encode this in the SCAN statement as 

SC DON r 'T GO '; ' STAY* 

Note that we have suppressed the special nature of the single quote 
by doubling it, and of the first semicolon by insulating it with 
single quotes (exactly in the same way as they are treated in WRITE 
operands when they are to be displayed literally (see pages 27^28)), 
The last character, i.e., the semicolon, remains active in its 
usual role as an end-of-statement delimiter. 

The above scan operand will match student input only if 
the operand contains 

DON'T 

GO 



and 



STAY 



in that order. 



The input may he festooned with all kinds of other words and marks 
without spoiling, the match: 



HALT DON'T GO AWAY MAD; PLEASE 



STAY} WON'T YOU??? 

Obviously the more we demand in a SCAN operand, the less 
chance it has of succeeding across a given set of answers , 'all 
expressing the seme idea, hut expressing It somewhat differently. 

So we try to remove as many constraints as possible, in order to 
improve the likelihood of matching answers which contain the essen- 
tial elements, 

SUBOPERANDS Often the coder will want to provide for 



will attain MATCH, In other words, he would like to perform a 
basic "OR" operation, as if he were testing the answer against 
a whole series of scans, each of which started afresh at the 
beginning of the ANSWER field. He cannot do this by stacking 
SCAN statements. 

SC $ 

followed immediately by 



will not lead to a match of 6^ in the student input, because the 
second SCAN statement resets whatever condition code was set by 
the previous SCAN statement. 

In order to describe how alternatives can be combined eco- 
nomically in a single SCAN statement, we need to deal with subord- 
inate parts of SCAN operands as modular entities . It is convenient 
to call these "suboperands" and define them as: ANY STRING, WITHIN 

AN OPERAND, THAT IS SEPARATED FROM OTHER PART (8) OF THE OPERAND BY 
A COMMA OR / I ff OR"-BAR (BOTH MEANING "OR"), OR BY AN AMPERSAND 
(MEANING "AND"). 



a number of acceptable alternatives con- 
veying similar meanings, any one of which 



SC SIX 



Example : 



operand 



SC AMLZ^ * 

suboperand suboperand 




Operation; The program scans the ANSWER field first for CORN; if 
MATCH is obtained, it sets the condition code and jumps to the 
next statement ? disregarding the second suboperand. If no match 
is obtained on CORN, it re-scans the ANSWER field for MAIZE. If 
match is obtained, it sets the condition code accordingly* Execu- 
tion then passes to the next statement. If neither is found, the 
condition code is set to FAIL and execution continues. 

Example: (U sub operands) 

SC OATS, PEAS | BEANS \ BLACK EYED PEAS; 
^ 7 "or"-'bars^ 



Operation: The program scans for each suboperand in sequence, de- 

sisting only when success is attained or the end-of-s tat ament 
delimiter is reached. 

Two or more suboperands separated by (an) ampersand(s ) will 
both (all) be scanned before success is assured, match condition 
code set,* and scan terminated* The order in which the sub- 
operand elements appear in the answer is immaterial: 



Example : 



operand 

SC SLEET & SNOW 

sub ope rand sub ope rand 



Operation: The program scans the answer field twice, first for 

SLEET, then for SNOW. Match condition code is not set unless both 
are found. 

This permits scanning for full permutations of lists where 
order is unimportant. 



Example: SC FIRE & WATER & EARTH & AIR; 



Operation: Four separate scans are performed. Failure on any one 

of them terminates the operation, while success Is not determined 
until all four have been scanned. If every possible combination 
had to be set up as a separate operand or suboperand (SC FIRE WATER 

EARTH AIR, WATER EARTH AIR FIRE, ete*_ .;) twenty-four of them 

would be required, and the whole series would have to be perronned 
to establish the absence of one of the required terms. 




* Condition codes are explained in THE DECISION PROCESS (page 6? ) - 

\ 




Any combination is per mis sable: 

FIRE & COLD WATER , EARTH £ AIR, FISH CHIPS \ 

CAKES ALE: (six suboperands) 

Operation : 

1, Scan for FIRE, If unsuccessful, go to next suboperand 

preceded by ( | ) or ( , ) , 

If successful, ...... * 

2, Scan for COLD and WATER - in that order .* If successful, 

set match condition code, jump to next 
statement (beyond the semicolon). If 
unsuccessful , go to the next suboperand pre- 
ceded by ( | ) or ( , ) 

3, Scan for EARTH. If unsuccessful, go to next suboperand 

preceded by ( | ) or (,)*,..... 

If successful 

k „ Scan for AIR. If successful, set match condition code, 

skip to next statement. If unsuccessful, 
go to next suboperand preceded by ( | ) or (,),,, 

5. Scan for FISH and CHIPS, in that order, with any number of 

characters and/or blanks intervening. If 
successful, set match condition code, jump 
to next statement. If unsuccessful, go to 
next suboperand preceded by ( | ) or ( ,) 

6. Scan for CAKES and ALE, in that order with any number of 

characters and/or blanks intervening. If 
unsuccessful, go to next statement. 



* Additional intervening blanks in the answer will not cause failure 
of this scan. Neither will intervening characters, as long 
long as they don't adjoin either of the specified words. For 
example , 

COLD WATER ] 

COLD WATER j would succeed 

COLD BLUE WATER 



WATER COLD 



would not succeed. 



From the above examples ¥e can deduce a rule: namely , that 

After scanning any suboperand ending with a 

comma, or | success terminates the operation 

failure goes to the next suboperand 

ampersand success goes to the next suboperand 

failure goes to the next suboperand 
which is preceded by a comma or n or ,! -b 

semicolon terminates the operation 



SPOILERS (— i ) In mechanics, a "spoiler 1 ’ is an attach- 

ment that reduces or neutralizes the 
effect of a device, such as deflection 
vanes used to reduce the lift of an airplane wing, the tinting 
blended into windshield glass, the mute on a trumpet. In 
DISCUS, we use the term in a more absolute sense, to apply to ' 
the "not" sign in a scan operand, 

SC -i CATS 

will match any answer field that does not contain the word CATS „ 

SC -iCATSj DOGS i 

will work as follows: 

Answer field Result 

DOGS ARE FRIENDLY CRITTERS Succeeds on not CATS 

I LIKE GATS AND DOGS Succeeds on DOGS 

I LIKE DOGS AND CATS Succeeds on DOGS 

CATS ARE EGOCENTRIC Fails on not CATS and 

the absence of DOGS, 

If one changes the order of the suboperands to 

SC DQGS 3 -r CATS 

the same results are obtained, but according to a different 
progression: 



DOGS ARE FRIENDLY CRITTERS 
I LIKE CATS AND DOGS 
I LIKE DOGS AND CATS 
CATS ARE EGOCENTRIC 



Succeeds on DOGS 

Succeeds on DOGS 

Succeeds on DOGS 

Fails on the absence 
of DOGS, and then again 
on not CATS, 



Clearly the intent of a spoiler and the words to which it applies 
is best served by placing them in a suboperand ahead of a desired 
element * 



An important distinction must be made between the effect of 
a snoiler in multi-word suboperand, and in suboperands which are 
separated by ampersands. In the former, the spoiler - regardless 


of its location - applies to each word 


in the suboperand. In the 


latter case 5 only to the word or words 
contains it. 


in the sub ope rand which 


With either .... 


SC CATS DOGS \ 


(These two statements 


SC CATS-* DOGS 


are equivalent . ) 


Answer field 


Result 


DOGS ARE FRIENDLY CRITTERS 


Failure 


I LIKE CATS AND DOGS 


Failure 


I LIKE DOGS AND CATS 


Fai lure 


CATS ARE EGOCENTRIC 


Failure 


I LIKE HORSES 


Success 


SC -i CATS & DOGS 


Answer field 


Result 


DOGS ARE FRIENDLY CRITTERS 


Success 


I LIKE CATS AND DOGS 


Failure 


I LIKE DOGS AND CATS 


Failure 


CATS ARE EGOCENTRIC 


Failure 


I LIKE HORSES 


Failure 



(Reversing the order has no effect 5 because both elements are 
tested before scanning terminates.) 

Thus if we wanted to match 

I prefer Hindemith to Chaminade but not 

I prefer Chaminade to Hindemith 

we would encode the scan statement either as 



SC HINDEMITH CHAMINADE & CHAMINADE HINDEMITH j 



or as 

SC HINDEMITH CHAMINADE S CHAMINADE — HINDEMITH ; 

But if we didn't care which he preferred as long as he specified 
both but didn't mention the Scarf Dance, we could encode it 

SC SCARF S HINDEMITH & CHAMINADE 

The "not” facility of DISCUS is a very powerful tool, per- 
mitting one to pack into one SCAN statement a number of par ame ters 
that ordinarily would require a whole series of statements , each 
needed to detect a specific undesirable element before getting down 
to the desired element and its alternatives. 

The j" also can be used to detect simple negation, in order 
to reduce one particular risk of misinterpreting input: 

Question W WHO IS PRESIDENT OF THE UNITED STATES 

(if) Answer A NOT NIXON 

Simple scan SC NIXON ; (Success) 

The program reaction in such a case would be exactly opposite 
to the one intended. Scanning the same input with a — • spoiler: 

SC SOT & 11IX0N-, (Failure) 

To cover a greater variety of possibilities, the scan would probably 
be written 

SC — NOT & NIXON -i AIN ' ’T & NIXON —> DON 'T S NIXON —> NO & NIXON ; 

[ (A Boolean expression such as 

(-•NOT, — » AIN' 'T, — ■ DON ' ' T, -» NO) & NIXON 

is not within the SCAN capability of DISCUS as currently implemented,] 
The same device could be used to handle double or even triple 
negatives in cases wherein these occurred as separate words, but 
simple reversals of meaning do not occur consistently enough in 
English to make this a very productive gambit. A really sophisti- 
cated not facility" should be able to unravel negative affixes as 
well as stand-alone forms of "not", so that the true polarity of 
meaning in a sentence could be established. 
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EXPANDING CONTENTS 
OF VARIABLES INTO 
OTHER STRINGS 



We have seen how DISCUS scans for elements 
specified in the SCAN operand- Let us now 
consider scansion for elements which are 



only referred-to in the operand. 

The contents of a variabJe statement may he referred to hy 
another statement only through its address, i.e., its label. Thus 

WRITE OH, THAT THIS TOO , TOO SOLID " ICECUBE " WOULD MELT \ 

writes the following on the screen 



only if somewhere in the program there exists a variable whose 
label is ICECUBE: and that contains the single word FLESH. If 
ICECUBE contained a laundry list, the whole thing would be dis- 
played between SOLID and WOULD. 

With a WRITE statement the contents of a variety of labelled 
data may be thus expanded into the operand. Since the ANSWER field 
is a variable, its contents may also be called forth at any time, 
but this should be done by referring to "ANSWER” rather than to a 
label which may have been attached to the ANSWER statement itself 
in a particular frame. 

Thus WRITE IN SAYING 9 "ANSWER" " NAME ", HAVE YOU 

CONSIDERED THAT "HORSES "? ; would be displayed as 



OH THAT THIS TOO TOO SOLID FLESH WOULD MELT 



/- 



f IN SAYING "I LIKE HORSES”, 

/ ROBERT, HAVE YOU CONSIDERED 
THAT HORSES ARE RELATIVELY 
INEFFICIENT? 




provided I LIKE HORSES is contained in the answer field, 

ROBERT is contained in a variable labelled NAME 



and 



HORSES ARE RELATIVELY INEFFICIENT is contained in a 



variable labelled HORSES. 



ERIC 
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Straight text may be set into a variable and left unchanged; 
it is still possible to scan for it - remembering, of course, that 
the chances of obtaining a match on exact text are fairly slim. 

At any given moment a variable may contain either a number 
(expressed as an integer) or a string of characters. The former 
might be scanned-for in the answer field if we wanted to know if 
the student had the right answer to a simple arithmetic problem 
he himself had constructed. The latter might be scanned for as a 
standard element expected to occur in a great many responses, or 
to check a unique item supplied earlier by the student himself. 

The entire length of a character variable expanded into a 
SCAN operand is treated by DISCUS as a literal. This means that 
imbedded commas, or-bars , and ampersands do not serve as logical 
operators in the SCAN statement. 

In a variable character string consisting of A,B,C the commas 
will be passive if the string is used in a SCAN operand. 

So in SC Qj where CC is the address of the above 

string the operand becomes 

Q, X 

/* V V. . 

active passive active 
and match will be obtained only if 

Q or 

A ,B ,C (including the commas) or 

C 

is present in the answer field* 

Further discussion of the SCAN statement must be deferred 
until Part III, after the remaining DISCUS OPCODES have been 
covered, in order to give the reader a better idea of how they 
behave as part of the total system. 
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VARIABLES 



There are no standard constants im- 



bedded in DISCUS. For example 
does not automatically conjure up 3 . 1 ^ 16 . 
If needed in a particular program it would first have to be sub- 
mitted as part of the source. For convenience we would establish 
it as a 'Variable,”' even though we probably wouldn’t plan to make 
any changes in it. 

A variable can be thought of as a box with a label on it, 
into which we can stuff things, later examining or copying 
their contents, adding to them, or emptying them out entirely.. 

We can be quite sure of the exact contents of the box, provided 
we put them there in the original coding and provided we allow 
no change to occur during execution. 

More frequently, however, we will want them to play a more 
dynamic role in on-line operations. At any given moment during 
execution, only the computer will know exactly what is in a vari- 
able used in this way. Neither our source program nor the object 
code listing will show it. 

The only way to gain access to a variable, specifically to its 
contents , is by referring to its label. In making such references, 
the label must always be surrounded by double quotes. Thus 

WRITE YOU HAVE COMPLETED "X tf PROBLEMS ; 
will cause display of 
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Other uses: 



Statement - A **X U ; 

Result - Causes the contents of X to be displayed following 
the carat . After the student types his answer 
and pushes the "send” button, the contents of n X" 
will be entered in the ANSWER field along with his 
input . 



Statement - SET ft X n - n I n ; 

Result - Causes the contents of X to be made identical 
with the current contents of Y. 



Statement - TEST "X " = 2; 

Resul t - Causes the contents of X to be tested to see if 
they are equal to 2. 



(SET and TEST statements are discussed in detail in the following 
pages . ) 



DEFINE(a) or D(A) To create a DISCUS variable, it must 

DEFINE ( C ) or D(C) , 

first be defined, either as an arithmetic 

variable or as a character variable,. And 

a label must be assigned to it at that time. 

ADDO: DEFINE (A> ; or ADDO: D(A) ; 



creates a numerical variable with a capacity from zero to over 
± two billion (to be exact, an IBM/360 full word integer). 

This variable will be accessible only through its unique la- 
bel - ADDO. 

CHAT: DEFINE(C) 30; or CHAT: D(C) 30; 

creates a character variable whose label (or name) is CHAT and 
whose maximum length will be 30 characters. We can specify as 
few as one (zero would be meaningless,) or as many as 255 5 but 
in any case some number must be stated, so that the compiler 
will know how much space to reserve for it. 

Neither of these two forms of DEFINE initialize the name variables 
Nothing is put into either box. To do that a SET statement is used. 
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SET or S 



SET uses the basic programming device of al- 
tering the contents of a variable of a field 
by restating its contents -with some change, 
if a change is desired. Using the examples on the preceding page, 
if it were desired to start ADDO off containing 10, we would simply 
follow the DEFINE statement with 

SET "ADDO" = 10 ; or S "ADDO" = 10 ; 

(the SET statement does not have to follow directly — there could 
be a long list of DEFINES followed by a long list of SETs.) After 
thus "initializing" ADDO, we can change its contents directly 
by restating them to be another number or to be the current quan- 
tity plus or minus something else, or divided by something, or 
multiplied by something, etc., but in any case the quantity to 
the right of the equal -sign - which is never omitted - is always 
the new value of that variable. 

If we desired that CHAT begin its career with the letter Z 
as its contents, the statement 

SET "CHAT" = 'Z'; or S "CHAT" = 'Z'-, 

would take care of the matter. Subsequent changes are effected 
along the same lines as with arithmetic variables; that is, the 
contents are restated either completely or by adding to the 
existing contents , as expressed to the right of the omnipresent 
equal sign. To eradicate the contents of either type of vari- 
able, one encodes nothing at all to the right of the equal— sign 
(not zero, which is something different from nothing). Thus 
the two variables above could be collapsed by 

SET "ADDO" = ; and SET "CHAT" = ; 

(although they still exist - with null contents). 

Note that the address label of a variable referred to in a 
SET statement is always enclosed in double quotes. This is 
consistent with the general rule that in order to refer to 
the contents of a variable through that variable's label, the 
label must be enclosed in double quotes . 
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SET establishes, in a variable, a specified combination of 
characters or numbers or other variables. The operation is 
always performed on the variable specified to the left of the 
equal- sign . 

Statements - CUPCAKE: D(A); 

MUFFIN : D(A) ; 

SET "CUPCAKE” = 3; 

SET "MUFFIN" = 4; 

SET " CUPCAKE " = "CUPCAKE" + "MUFFIN"; 

Result - ,f CUPCAKE ,f now contains the number 7* 

"MUFFIN" still contains the number h> 

Statement - SET "CUPCAKE" « "MUFFIN"; 

Result - Both "CUPCAKE" and "MUFFIN” contain k . 

Statement - SET "MUFFIN" = "MUFFIN" + 20 - "CUPCAKE 

Result - "MUFFIN" contains 21. "CUPCAKE" still contains k . 

The arithmetical operators are 

+ add 

- subtract 

* multiply 

/ divide 

The arithmetic operations are performed sequentially, from 
left to right. The results of each separate operation is pro- 
gressively rounded off to the lesser integer before going on 
to the next operation (i.e., truncated). 

St atement - SET » MUFFIN " ~ "CUPCAKE" *7+1/3; 

Result - "MUFFIN" contains 9 > not 9*66666 or 9 2/3. 



(l+x7=28; 28 +1= 29 ; 29 * 3 = 9 2/3 ; lesser integer = 9) 



The nature of the variable to be set, i.e. , the one to the 
left of the equal-sign in the SET operand, determines the nature 
of the operation to be performed. If it was originally defined 
with a D(A) , the operation will be arithmetical: 

Statement — SET ” CUPCAKE " = 365 + 144 j 

Result - "CUPCAKE” contains 509, not 3651^. 

If through error or otherwise there is an attempt to add non- 
numeric characters to an arithmetic variable, they will cheerfully 
be disregarded. 

Statement - SET " CUPCAKE " = 365 + ’DAYS’ j 

Result - "CUPCAKE” contains 365 (not 365 DAYS or 3650 .) 
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In a character variable - one defined by a D(C) statement - 
no arithmetic operation takes place, regardless of whether numbers 
or characters are used. 

Example 

Statements - PIE: D(C) 30; 

S ?r P.TE ,T = '4'; 

S tr PIE " - "PIE" ' AND' ' 20 9 ' BLACKBIRDS' ; 

Result PIE contains 

k Am 20 BLACKBIRDS (not 2b AND BLACKBIRDS ) 

Note that character strings are entered in SET operands as 
literals, i.e., surrounded by single quotes, if they are entered 
directly, as in the example above. If they are entered indirectly 
i.e., by reference to the contents of another labelled variable, 
the label specified in the operand is enclosed in double quotes.* 

If a blank is needed in order to separate two literals, it 
must be specified. Hence 1 AND* and 1 20 1 and f BLACKBIRDS 1 above, 
not 'AND' and ! 20 ' and BLACKBIRDS 1 . 

Non-literal blanks mean nothing at all in the operand: 

S tr PIE" - "PIE" ' ' 'AND' ' ' 'BLACKBIRDS'; 

and 

S fr PlE" ~ "PIE" ' ' 'AND' ' ' 'BLACKBIRDS'; 

would have identical results. 

If the operand were written 

S "PIE" = "PIE" 'AND' '20' 'BLACKBIRDS'; 

the resultant content of PIE would be 

UAND20 BLACKBIRDS . 

The SET command provides a means of saving student answers 
for later user, but the maneuver must be performed before the next 
ANSWER statement is encountered, since every new answer annihilates 
whatever preceded it in the ANSWER field. 

*This follows the general rule that the contents of a labelled statement 
are always referred to by specifying that label. When referring to the 
contents of a variable , its name (label) must, in addition, be enclosed 
in double quotes. 



The contents of the current ANSWER field may be added to the 
existing contents of a variable either ahead of or following them, 
or inserted between two or more specified elements. In the fol- 
lowing example we add the student’s last name to a previously- 
saved first name: 



Statement 



Result 



W WHAT IS YOUR FIRST NAME?; 

A; (student types WILLIAM) 

S "NAME" = "ANSWER"; 

W THANK YOU . NOW YOUR LAST NAME * PLEASE . ; 

A; (student types MAKEPEACE) 

S "NAME" = "NAME" ' ' "ANSWER"; 

W WELCOME TO ENGLISH I, "NAME"; 

(contents of current ANSWER field added on the 
right ) 
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/welcome TO ENGLISH I, 
WILLIAM MAKEPEACE 






V 




In the following example we add the student’s first name to 
a previously-saved last name: 



Statement 



W WHAT IS YOUR LAST NAME?; 

A; (student types MAKEPEACE) 

S "NAME " = "ANSWER "; 

W THANK YOU . NOW YOUR FIRST NAME, PLEASE. ; 
A; (student types WILLIAM) 

S "NAME" = "ANSWER" ' ' "NAME"; 

W WELCOME TO ENGLISH I, "NAME"; 



Result 



The s ame 



If the original DEFINE statement for a character variable has 
reserved too little space to accommodate the material which one 
later tries to SET into it, the SET statement which exceeds the 



Assume "NAME" has been previously defined as a character variable 
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available space does not fail altogether, but manages to enter as 
many characters as possible, starting from the left end of the 
input string. The remainder vanish. This could be useful if the en- 
coder wanted to throw away all but the first n_ characters of an 
answer, but more commonly the D(C) should specify ample room for 
everything expected to go into it. 



TEST or T The TEST statement compares two variables with 

each other, or a variable with a literal, and 
sets a condition code* to positive if "sue- 
cessful" according to the terms of the relational operator 
(equals = ; greater than > ; less than < ; not -» . They may 
be clustered or used sdngley.) As with SET, the object of the 
comparison is the element to the left of the relational operator. 

TEST ”A" > ” B” ; 

will result in a positive condition if A is in fact greater than B. 

The type of comparison is determined by the object variable. 

If it is arithmetical, the second variable is dealt with as such, 
if at all possible. For example, suppose the following is attempted: 

Statements - CUP : D ( A ) ; 

SAUCER: D(C) 20; 

S ’’CUP” ^ 10; 

S tf SAUCER ” = ’BUTTERFIELD 8’; 

T "CUP" > ’’SAUCER 

Result - Positive 

The program will compare the contents of CUP with the 8 in 
SAUCER, and disregard the alphabetical characters and the blank. 

If the object variable is a character variable and the 
second variable is arithmetic, the contents of the latter will 
be dealt with as a character string. 



*The use of condition codes is explained in THE DECISION PROCESS 

p. 67 . 



Statements 



X: 

Y: 



Example 



D(A) ; 

D( C ) 20; 

S "X" = 

S "Y" = 

S "X" = 

TEST "X" = 



456 

'45 

"Y" ’6’; 

rr Y f, S will succeed. 



If both variables are character vai’iables , then the 
smaller of the two is padded with blanks on the right , and a 
character-by~ character comparison takes place. 



E xamples 

(Assume "Q" is a numerical variable containing 4 

it m r !1 m m m t! 11 6 

" . "S” " " character " " ’GRAVY’) 

TEST "Q" = "R"-, will fail, because 4 is not equal numerically to 6. 

TEST tf R n > n S n ; will succeed, because GRAVY contains no number 
greater than 6 (in fact, no number at all.) 

TEST r, S n — i > = n Q rr ; will succeed, because GRAVY is neither greater 

than nor equal to * 

In the following example we test i±. nother character 

variable "T tf containing 1 GRA ' : 

TEST M S M = f, T ,f ; will fail, because 1 GRAVY ! is not the same as GRA. 



A strong similarity exists between TEST and SCAN. SCAN is 
really a kind of moving TEST, which sweeps from left to right 
across the variable being tested, i.e. , the ANSWER field. The 
SCAN relational operator - in this analogy - is always - . 
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Both TEST and SCAN result in the setting of a condition code 
to indicate success or failure , so that a determination can "be 
made as to what will happen next in the execution of the program. 



To illustrate these operations 9 two examples are needed: 

{AJ To verify the exact contents of a variable (TEST) 

To ascertain if a character variable contains one or more 
specified elements. (SCAN) 

© Suppose the student is asked to furnish the last four 
digits of his social security number in order to use it as a code 
number on restart. Either a character variable or a numerical 
variable could be used to store these four digits , but it would 
be better to use a numerical variable in order to eliminate 
"noise" . Compare: 



SEC: D(A); 

(Student types U 0K. 5321") 
S 19 SEC 11 - "ANSWER"; 
Result : 



SOC: D(C) 20; 

j (Student types "OK. 5321") 
{ S "SOC" » "ANSWER "j 



SEC contains 



5321 



I 

I SOC contains 

I 



OK. 5321 



because whenever an attempt 
is made to put characters 
into an arithmetic variable 5 | 

they are automatically thrown | 
away , without affecting the | 
numerical entry. | 

When the student signs in for his next session, the system will 
bring his data set out of storage. The program can then ask him 
to confirm his identity by again giving the last four digits of his 
social security number. Suppose this time he types "5321". 



Result : 



T "ANSWER" sr "SEC " J 

will succeed. 



T "ANSWER" - "SOC" i 

will fail. 

If SOC had been limited to 
four characters by 

SOC: D(C) k: 

it would contain OK.fe 
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it would "be a good idea to check 
SEC immediately after the origi- 
nal input to see if it contained 
a four-digit number, as follows: 



and still fail. One could 
check SOC immediately after 
the original input to see if 
it did in fact contain a four- 
digit number , hut the routine 
for this is fairly tricky 
and (machine) time consuming. 

On the other hand 



T "SEC" > 9999; 



M; 

W JUST FOUR DIGITS 3 PLEASE. ; 

J ( label of AN SWER statement); 
E; * 

T "SEC" = < 1000 ; 

W FOUR DIGITS j PLEASE, j** 

J (l abel of ANS WER statement ) ; 
E; 



® In this example suppose we have been stuffing words from 
successive answers into a character variable defined as 

CITIES: D(C) 250; 

and we would like the program to be able to ascertain - at some 
time during execution - if the variable contained either MEMPHIS 
CHATTANOOGA. Since TEST tests for all or nothing at all, it 
won’t work here. But we can use SCAN for the purpose: 

(Assume we have another character variable called "TEMP" lying 
around, which we can use temporarily to store the current con- 
tents of the ANSWER field while we use the ANSWER field for 
SCANning something else.) 



* 'Jse of these opcodes is explained in THE DECISION PROCES , 

pag^ 67 . 

** A dually, one or more additional tests would be needed here 
to crack for leading zeros, e.g. , to validate a four-digit 
number such as 00i+3- 
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s "TEMP" = "ANSWER" i 
S "ANSWER" = "CITIES " ; 

SC MEMPHIS j ' CHAT’ ’ GA ’; 

F; * 

W YOU HAVEN ’ ’T MENTIONED EITHER MEMPHIS 
OR CHATTANOOGA. ; 

S "ANSWER" = "TEMP"-, 

E; 

Or, turning the procedure around in order to detect repetitions: 



TENN: A; 

SC MEMPHIS j ’ CHAT’ ’GA ’ \ 

M; * 

S "TEMP" = "ANSWER" > 

S "ANSWER" = "CITIES"-, 

SC MEMPHIS 3 ’ CHAT’ ’GA ' ; 

M;* 

W YOU ALREADY MENTIONED "TEMP"-, 



W CORRECT . ; 

S "CITIES" = "CITIES" ' ' "TEMP "I 
S "ANSWER" = "TEMP"-,** 

E;* 



etc . 

There is no need to restore "ANSWER" at this point, 
because the next input will clear it. 



*CJse of these opcodes is explained in THE DECISION PROCESS, 
page 67. 

^Actually, there is no need to restore "ANSWER" at this 
point, because the next input from the student will clear 
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THE DECISION PROCESS 



In DISCUS, the decision process can 
lead to a number of actions such as 
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"jumping" to another location in the program and resuming 
execution at that point; 

displaying the contents of a variable; 

changing the contents of a variable; 

"using" a section of code located at some other part of 
the program; 

displaying a string of text; 

causing the DISCUS system to await student input; 
invoking author mode (discussed on pages 137-lUo); 
automatically terminating execution; 

or simply passing execution to the next statement in sequence. 

To illustrate, suppose SCORE represents an arithmetic variable which 
the course author wishes to increment every time the student answers 
a question correctly. Then let us imagine a successful match on the 
following: 

SC BATS; 

As a result, we want to process the following statement: 

SET "SCORE" = "SCORE" -hi; 

However, before the program encounters the SET statement, we will 

want to insert a proviso that it be executed only if a match in fact 

did occur; we don't want the SET statement to be executed 

otherwise. To provide for this selective treatment, a new DISCUS 

statement is used, its opcode being MATCH, or M. It needs no label 

or operand. It simply says to the computer, "if the current condition 

code - as set by the most recently executed TEST or SCAN operation - 

is positive, let the next operation take place. Otherwise, skip it." 

So the sequence would be encoded: 

— SCm~BATS^ - , 

MATCH; 

SET "SCORE" = "SCORE" -h i; 

The same kind of arrangement can govern other actions: 

TEST "SCORE" 8; 

MATCH; 

WRITE YOU ARE DOING VERY WELL . YOUR CURRENT 
SCORE IS "SCORE".; 

7Z 

-61- 



The program is not limited to doing only one thing per test or 
match : 



SCAN HELEN OF TROY; 

MATCH: 

SET "SCORE” = "SCORE" + 1; 

SET " TROJAN " = "ANSWER"; 

We can now close off this little routine and then do something 
about the failures. An END statement - again consisting solely 
of the opcode - is used: 

END; ( or E; ) 

This can be followed by an action which will always take place if 
there has been no match, in effect saying to the computer, !, If the 
current condition code is not positive, let the following operation 
take place ; ,? 

FAIL ; 

WRITE NO. IT WAS HELEN OF TROY; 

SET "SCORE" = "SCORE” - 1; 

JUMP (to some other label address); 

END ; 



MATCH AND FAIL One can limit the number of times a given 

COUNTERS MATCH or FAIL statement will operate during 

processing of the section of code wherein 
it is located, by adding a blank, followed by a limiting numeric 
expression, to the MATCH or FAIL opcode. Actually, this limiting 
value is part of the operand of the MATCH or FAIL statement . 



MATCH 1; or M 1; will be. processed no more than 

mice , "then s unstressed , along 
with all stairenEnts that depend 
.cm it . 

EAIL 2; or F 2; wi.ll be processed no more than 

twice, then suppressed, along 
with all. the statements that 
depend on it . 

The way in which this feature may be explonned will be demon- 
strated after we have considered the decision process . For 
direct reference, see page 82 . 



JUMP or J JUMP is fairly self-evident. A JUMP state- 

ment transfers control unconditionally to 
the opcode associated with a label that has 
been specified in the operand of the JUMP statement. Thus JUMP RUNCIBLE ; 
will cause processing to switch to that part of the program where a state:- 
ment labelled RUNCIBLE is to be found, and to resume sequential process- 
ing at that point. Note that the destination- label is not in quotes. 

(ONLY the labels of variables should be in double quotes when they are 
referred to in the operand of a statement.) 

The JUMP statement itself may, of course, be labelled, e.g., 

SPOON: JUMP RUNCIBLE; (if at the destination we were to find 

RUNCIBLE: JUMP SPOON;, an infinite loop would result. DISCUS 

squelches infinite loops after a large fixed number of cycles . ) 

JUMP is arbitrarily suppressed when it would, if executed, vio- 



late condition code levels 


in 


a block structure. This 


will be explained 


after we consider the 


decision 


process . 






RECAPITULATION 




Thus 


far we have 


dis cussed 


a number of 








OPCODES and the statements 


which they 








govern: 








WRITE 




or 




W 


(p- 22 ) 






WRITE(NF) 




or 




W(NF) 


(p. 30 ) 






WRITE (ND) 




or 




W(ND) 


(P* 31 ) 






ANSWER 




or 




A 


(p. 3^ ) 






ANSWER (NF) 




or 




a(nf ) 


(p. 39 ) 






SCAN 




or 




s 


(p. ko ) 






DEFINE (A) 




or 




D(A.) 


(p. 56 ) 






DEFINE ( C ) 




or 




d(c); 


(p. 56 ) 






SET 




or 




s 


(P- 57 ) 






-TEST 




or 




T 


(p. 67 ) 






JUMP 




or 




J 


( ab ove ) 




It has 


been stated that SCAN and TEST govern 


the decision process , 


and in 


demons trading 


this 


we have 


briefly touched upon 


four addi- 


tional 


OPCODES: 
















MATCH 


or 




M 


(P* 
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FAIL 


or 




F 


(p. 68 ) 






END 


or 




E 


(p- 


68 ) 




The intricacies 


of MATCH, 


FAEL, and END 


can be properly 



understood only after a general discussion of the "block structure, 11 



whi ch fo Plows . 



THE BLOCK In order to appreciate what a block 

STRUCTURE ^ ^ . 

structure m CAI can do for us, it is 

necessary to review the factors which 

have led to its development. 

CAI programs and the f, language ,f systems in which they are 
implemented can be described generally along the following lines: 



Step 1 
Step 2 
Step 3 
Step h 



Step 5 



A chunk of instructional text is displayed. 

A question is displayed 

The student answers the question 

The answer is checked against pre-specif ied 

strings in order to determine 

a. if it is "correct" 

b. if it is "incorrect" 

c. if it cannot be recognized as either 
Program reactions unique to ha., 1+b , and he are 
arranged for each case, such as 

the display of text which purports to 
comment on the answer 
the display of text which suggests or 
states the answer sought 
the incrementing of a score variable 
jumping to the next chunk of instructional 
text 

jumping to another part of the r* 1 gram. 



The ea^e With which a CAX mechanism can be described along 
these lines can lead to its being oversold on precisely those 
points where it is often weakest: perceptiveness (Step 4) and 

versatility (Step 5 « ) Efforts to make CAI programming as simple 
as possible can lead to routines that work in only one way, where- 
as the intellectual aspects of a unit of dialogue may call for 
elaborate options .... at least if the idea of dialogue is to be 
sustained at all. Otherwise it is a little like trying to paint 
a picture without being allowed to mix the colors. 

The situation is typified in connection with the program re- 
actions listed in Step 5, above. A very simple CAI language is 
limited to working in one or the other of two basic condition- code 
settings, and is governed through a whole series of operations in 
a given frame by that one setting. Such frames tend to be sequence- 
bound, that is, reactions to matches must - both in the source 
coding and in the object module — precede the reactions to non- 
matches. There are usually ways to program around these constraints. 
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but this sort of effort is not a happy investment. 

DISCUS reduces opcodes to their simplest terms, each designed 
to do one thing and to do that one thing invariably - regardless 
of condition code setting. Then it provides two special opcodes 
whose sole task is to act as gates — one of them opening only 
if the condition code which governs it has been set to indicate 
a "success," the other only if the condition code which governs 
it has been set to indicate "failure." These are the MATCH and 
FAIL opcodes.* 

Instead of a command meaning "WRITE IF A MATCH HAS BEEN MADE" 
we use the command WRITE or W, meaning "WRITE IF YOU GET A CHANCE", 
and ahead of it place a MATCH statement which will bar execution of 
the WRITE unless the condition code setting at the moment indicates 
M success . f1 * 

In the same way, instead of a command saying "WRITE THIS IF NO 
MATCH HAS BEEN MADE," we again use WRITE, but precede it with a FAIL 
statement to -event execution if the condition code is set to other 
than "fail . 1 

This may be done across a range of elements, each of which is 
to be checked. Or it may be done on a contingent basis, i.e.. 



Block level 
of nesting 

1 

2 

3 

k 

5 

6 
T 
8 
9 

10 

11 

12 

13 



Check for A 
If A is true. 
" B “ " 

IT q M tl 

T1 -q IT fT 

" E i. v 

TT p ft ff 

Tl q T! Tf 

TT pj TT ft 

IT j TT n 

" J " 

Tl p- IT ft 

,T L tl 



rrssck for B, 



IT 



11 c 

D 
E 
F 



TT! IT 



TT 

Tl 



rt 

ii 

ii 



T H. 
I , 
J 
K 
L, 
M 



otherwise pass 

IT If 

II " 

Tl If 

TT T I 

TT If 

IT If 

Tl ff 

Tl ff 

IT ff 

TT If 

IT ff 



to point Z 

IT fi y 

TT IT yr 

ff ff W 

f? ff y 

" " nr 

IT ff Ijr 

If ff Q 

„ , l 

" " Q. 

ii ff p: 

TT ff Q 



(to maximum 
dept of 255) 



* Professional programmers may object to the terminology , but fair 
purposes of this Manual we equate the words "success = MATCH = 
"positive" ; "failure" - TAIL. = "negative". 






A condition code could be represented with a small square of 
cardboard to which a swinging arrow had been attached in such a 
way that it would point to either one of two possible conditions, 
success or failure: 





Now let us require the computer to remember how the arrow pointed 
a moment ago, even though the current setting may have changed. 
This is certainly storable information, and we want to be able to 
retrieve it in reverse sequence. It is as if we were to stuff a 
whole series of remembered settings into a tube, and retrieve them 
according to the order in which they were stored away: 



The setting The last pre- The first pre- 

of the moment vious setting vious setting 

l ‘ ^ i 




Along with each setting, its storage sequence number is noted. 

This number indicates the level or that particular setting. By 
letting the level determine whether or not a MATCH or FAIL will 
even be considered, a vastly expanded set of options is made 
available. This is the idea of block structure. It gives 
DISCUS a 2 -dimensional aspect rather than one which is simply 
linear . 

Every test carried out, whether it be dictated by a SCAN 
opcode or a TEST opcode, results in a condition-code setting. 
Action which follows (e.g., WRITE, SET, JUMP, etc.) may take place 



€ ' 



immediately , or it may "be deferred until after one or more addi- 
tional tests in the nest are performed, "but in any case it can 
take place only at the prescribed level preserved by the MATCH 
(or FAIL) which sanctioned it. 

How does one emerge from a deep level of operation? Simply 
through use of the END (or E) opcode. We pull the remembered 
settings out of the tube, as it were, and throw them away one "by 
one, with an END statement for each preceding MATCH or FAIL state- 
ment in the nest. Sooner or later, hack at Level 1, the total 
number of END statements in the text must equal the sum of MATCH 
and FAIL statements . 

The following is an executable sequence* 



SCAN; 

MATCH; 



} 



TEST; 
MATCH ; J 



TEST; 1 
MATCH ; J 



SET; 

SCAN; 

MATCH; 



WRITE; 



END; 



END; 



END; 

END; 



Total MATCH + FAIL = h 
Total END = h 



Level 1 
Level 2 
Level 3 

Level h 

Level 5 
Level h 
Level 3 
Level 2 
Level 1 



*As a convention for listing blocked coding, we sometimes use 
indentations resembling those employed in FOIL. It should be 
emphasized that they have no operative significance In DISCUS coding, 
however, but are intended only to help the reader visualize the block 
structure. 



It is possible to jump out of a series of nested blocks at 



any point . 



SCAN ; 
MATCH; 



J 



Level 1 



SET; 

SCAN; 

MATCH; 



} 



Level 2 



TEST ; 
MATCH; 



} 



Level 3 



JUMP (to some labelled location ); Level h 



END; 



Level 3 



END; 

JUMP (to some other labelled location 




Level 2 



END; 



Level 1 



The fact that execution in some cases never reaches the END state- 
ments at the far side of the block structure does not change the 
coding requirement: the END statements must always be there, and 

they must always equal in number the total number of MATCHes and 
FAILs used in the block. Thus in 



the END is indispensable. 

While there is no restriction against jumping out of a nested 
block to a location encoded in such a way that it would be at a 
different level, care must be taken that the net effect is not to 
try to reach a level of less than 1. The total number of END state- 
ments encountered must not exceed the sum of the number of MATCH 
and FAIL statements passed- through , since going below level 1, 

The current state of the condition code, as to whether it is 
set at success or failure, controls entry into a MATCH or FAIL 
block - either within the same nest or in another nest which has 
been JUMPed-to. When a block is successfully entered, the condi- 
tion code that enabled the entry is preserved and a new level of 



MATCH; 

JUMP (to label address specified in operand) ; 

END; 
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condition code is "brought into use. If no new TEST or SCAN is 
executed on this new level, the condition code as previously set 
is used. The next END statement in sequence "brings the condition 
code to the next higher level in use, after saving the current 
code. 



Example : 




(explanation "below) 


© 


W 


NAME THE THREE GRACES . ; 


© 


A; 




© 


SC 


AGLAIA ; 


© 


M; 




© 




W AGLAIA WAS FOUND; 


© 




SC THALIA; 


© 




M; 


© 




W THALIA WAS FOUND . ; 


© 




SC EUPHROSYNE; 


© 




M; 


© 




W EUPHROSYNE WAS FOUND. ; 


0 ) 




J XX; 


© 




E; 


© 




E; 


© 




W WE ARE NOT SURE ABOUT EUPHROSYNE 

DEFINITELY MISSING. ; 


(L6) XX: 


E; 





Explanation (Assume student answers "Aglaia, Clio, and Minerva.") 
Statement ( 3 ) looks for AGLAIA in the answer field, and since 
AGLAIA is found, the MATCH "block starting at statement ©is 
entered and the message at statement (T) is written on the 
screen* Since the scan for THALIA fails, the MATCH "block 
starting at statement (T) is not entered, and execution con- 
tinues at statement , t" hich corresponds to the 

termination of the MATCH "block ^te ing at (V) » The sentence 
in the operand field of statement (15) is then displayed. 

Thus each MATCH or FAIL "block is terminated with a corres- 
ponding END, and, if the "block is not entered, all the contents 
of that "block are skipped and execution proceeds to the corres- 
ponding END. gQ*: 
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When a block is not entered because of condition codes not 

o 

being favorable, all the nested statements 'within the by -passed 
block are ignored. Thus if a block on level 5 is encountered, but 
not entered because the condition code setting of the moment is 
fai lure while entry is. contingent on match , or vice versa, and that 
block contains nested blocks at levels 6, 7» and 8, execution 
crosses over to level 5 beyond them, i.e., to the corresponding END 
statement. 
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BLOCK or B There is one more OPCODE to he mentioned 

in connection with the DISCUS block struc- 
ture, one of fairly recent development. 

The necessity for this nev opcode - BLOCK - became evident only 
after finding that we needed a simple way of setting nested blocks 
apart as subroutines without too much concern as "to where they 
occurred in the execution stream. 

BLOCK simply stands in place of either MATCH or TAIL opcci^S' 
when the current condition code setting is immaneria . ^and all. that 
is desired is to bracket a section of code . (An le is : rf yen 

on page 78.) 

The rule about END statements can now be r-sTate. - THE SUM 
OF ALL END STATEMENTS IN A BLOCK MUST EQUAL THE '0*~ /.LL MATCH, 

FAIL , AND BLOCK STATEMENTS. 

USE or U A USE statement causes one t more logical 

instructions located eise^here in the pro- 
gram to be executed as ±r they were actu- 
ally listed at the location of the USE. The operand of a USE 
statement is always the single statement label address indicating the 
location of the instruct ion ( s ) to be executed. The label is not 
enclosed in quotes . 

The scope of the USE depends on the nature of the statement 
bearing the access label specified in the USE opersad: 

a. If it is a FRAME statement (e.g., AAA:ER^T-; or AAA: FR ; )* 
then the entire frame is executed. 

b. If it is a MATCH, FAIL, or BLOCK statemem., then all 
commands at or below the entry point leveH”will be 
executed, until the end of the block is reached. 

c. All other statements are executed as individual entities. 

As a corollary, execution returns to the point immediately after the 
USE statement when execution 



*Dis cussed in next section. 
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a. 



The next FRAME statement , if a FRAME has been USEL 

b. The first END statement encountered at the level am 
which the block was entered. 

c. At the delimiter (;} of any other statement UFFT other than 
FRAME, MATCH, FAIL or BLOCK. 

There will be numerous instances wherein the coder wn.ll • znt 
•mo use USE for bookkeeping operations. These are discussed i. the 
section on useful subrcrcrtine s in Part III, 

The usefulness of USE can be exemplified briefly as f cl '«■£,; 

a. Suppose the programmer has written a particular rov hre 

for’ Inviting :signoff\, such as "You have been working for uri mutes 

n ' n and your scoring rate is . Do you want to stop four ^iiw. 1I5 " 

He ' ._ght want to be able to call up this routine at several czdieirer 
ponnts in ~zhe program, and he can do so by delimiting it with a 
BIiA'JK statement , the first of which he could label TIRED . ±Le : nidi 

then implant the following statement at several points in him joi: r:y'rv: 

USE TIRED; 

with the same effect as if he had repeated the entire routine ai , 
each location, 

b. Suppose the programmer has written a testing routine tc 
determine the "scoring rate" and to govern use of the frame 
described above, and for this purpose uses a block such as the 
following : 

SCORCHK: B; 

S "STALLY" = "TTALLY" / "UTALLY"; 

T "STALLY > 7 ; 

M; 

U TIRED; 

E; 

E-; 

He needn’t repeat this every time he wants to employ it in the 
program. USE SCORCHK; will suffice. 

c. Suppose the programmer has prepared a lengthy /TRITE 
statement (such as a arefuily formatted list of eategcri ‘ 



O 

ERIC 
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He can effectively insert this single statement anywhere in 
his program simply by referring to its label in the operand 
of a 113 E statement; e.g. USE ILIST22. UNLESS THE STATEMENT 
USED Is a MATCH, FAIL, BLOCK, or FRAME statement, processing 
r everts immediately on reaching the first delimiting semicolon 
after the location cited in the USE operand . 

Examples given following explanation of FRAME (next 
section) dermcms trat e some additional applications of USE. 



FRAME or EE A FRAME statement marks the beginning 

of a segment of code. Also the word 
"frame” can mean the entire list of in- 
strnrirLons (statements ) beginning with a FRAME statement and 
ending so the next FRAME statement. For clarity we will indicate 
the word t;ms second sense by printing it always in lower 
case. 




FRAME statements serve as reference point for entry or re- 
entry into a particular sequence of code. They do very little 
processings as such, and contain no operand. They may, however, 
be labelled and through such a label reached by means of a JUMP 
or USE from some other part of the program. When accessed in this 
or any other way they simply pass execution to the next statement 
in sequence. 

The DISCUS compiler will cause a line of hyphens to be printed 
out in ih - object listing immediately ahead of the FRAME statement. 
(See example on page 24.) This is helpful in scanning and checking 
the program after it has been compiled. 

A typical frame begins with a display of text followed by a 
directive that will elicit a response from the student. 
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Next follows an ANSWER statement, then one or more scanning 
and testing operations witm their train of contingent actions: 
display oi additional t exit and comment, -Scoring, branching 
to other routines, returning to the AMSWDl statement, etc. 

After all the ope?raoio.ns specified m connection with 
that particular ANSWER: statement have b^ssr. encoded, and the 
coder is ready to gc or to the next inst vucet ional step, he 
will pr oh ably decide ter start a new frame (with a 1BAME 
statement ) . 

The frame - as a unit of instruction - is a teaching con- 
cept derived from earlier work in the desrgn of programmed 
textbooks and teaching machines- Blocks rff tsxt, with multiple 
choices appended, were actually enclosed cm a meet angular 
11 frame, " in the former- Below this figure appeared directions 
as to which page to turn to, depending on the student y s choice 
of answer. Teaching machines concealed the correct answers 
mechanically until the student pushed a slide which carried 
his own answer irretrievably into the machine's insides. 

Although computer-assisted instruction frees us from the 
constraints of the programmed textbook and its mechanical 
counterpart, it is only* natural that an author /ins true tor should 
at first favor :frame-like steps in developing his material. 
Later, the fact that fee can use pieces of* frames whenever he 
wishes, can return to whole families of frames at will, or 
jump from the middle of one frame to the beginning or middle 
of another, in due course will persuade him its* structure his 
material more flexibly After all, the frame as. such does not 
govern the execution of the program; it is jus: one way of ssg- 
menting the flow of doe as . 

A frame can be extremely short and simpl&,, or so long and 
complicated that it involves hundreds o:f sta tement s . If a 
definition is needed, me might say that a franis is a sequence 
of statements that contains one and only one AMEMER statement. 
This takes care of the kind of frame that makes no didactic 
pronouncement, but simply gives the student a drance to respond 
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to -something posed in a rate ion WRITE in another frame (or in 
ser ml other frames). It h so covers the most Intricate 
scam and structures v In follow the ANSWER statement 

bef/re t Is next ANSWER sta ment occurs in the coding sequence. 

Tbit definition does mot specif - / FRAME as a delimiter, 
he cense -/ns FRAME STATEMENT IS PRIMARILY A. ..LOCATOR . It has an 
import an* : fhzmvloii in cemsnn operations, hut its presence or 
absence : s mo directly manifest e I. To euplain : 

RRAiiE cs.ii he thought of , ass the concierge of a small hotel, 
a hotel v'ith '-vide— open windows* all on the ground floor. One 
car. enter by way of a window id leave the scene way, and the 
conmerge wi 12 never he the v is-er . If, hove^r , one goes in 
hy the front door, past the .nrncierge, the Tarter unobtrusively 
mak^a a mete cl* it and immediately notifies -Headquarters . 

Now Tet us say that the -upest disappears - that is, the 
student signs off for the day. The record of his last known 
whereabouts is lent on file, and when he signs it again, Head- 
quarters ~wilT see to it that that is where '^"materializes 
agaum . 

Not mo belabor the anal.ngr further, let ns say that we 
use a pohrrter system, and every time a FRAME. ..statement is 
passed through^ that location is recorded in a pointer and 
the record of the previous ssMress in erased. The block level 
applying to the current qpesgfcnon is also rec mded. Accordingly, 
the prog- ram konows where he resume execution enter it has been 
interrupted^ and at Tfet condition cede leveh This is the 
ME'EThRT mentioned earlier . 

FR®£E fuLfiXLs sni 11 smother function in connection with 
'MATCH shlH counters: . Whenever a FRAME statement is exe- 
cuted, "HI JM^OTCH, FAIL and HTOCK counters are set to zero. 
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Now that the reader has been introduced to block struc- 
ture^ le can mere readily appreciate the utility of the MATCH 
and EA.iL ecnnteirs of which we spoke earlier (page 68 ). Since 
these counters also work with BLOCK statements, we can refer 
to them, as ItATCH- FAIL-BLOCK gt "MFB ,n counters. 

In the frliowing example, the statements which are itali - 
cized illustrate the operation of this device: 

RUBENS : W WE&I TOO COLORS COMBINE TO MAKE ORANGE ? ; 

AS 

3C RSE & YELLOW; 

A; 

W C iKHEICT ; 

J TT^T& jST; 

E; 

SC lEXD ; 

M 1 £ 

W RED IS CORRECT, j Provided the student doesn't get 

both right in the first scan, 
process ing will test first for "red” 
in the answer, and respond with 
this , one time only. 

S '"TALLY” = t, TfiLiar tt + 1; 

\ "TALLY” = 2; 

M; 

WtND) BED AND YELLOW ikSE.--. (etc. ); 

J i TEXAN; 

Ej 

J R^ltENEz; 

Ej 

M; 

W YOU ALREADY SAID /n REP* n *.j The next time around, and 

thereafter, if the student answers 
"rad,” this MATCH block will be 
used instead. 

J RUBENS ; 

E; 

SC YELLOW 

(example continued on next page.) 
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M 1- 

W YELLOW IS CORRECT.: Will be processed once only. 

S '"TALLY" = "TALXT" - 1; 

T "TALLY" = 2; 

M; 

W(NH) RED AMD YEIILOW ARE. . . (etc. ); 

J TITIAN; 

E; 

<1 RUBENS; 

E; 

Mj This MATCH will operate the second 

time, and thereafter, after a 
response of "yellow. " 

W YOU ALREADY SAID YELLOW j 

J RUBENS; 

E; 

F 2j Response for the first two FAIIS 

W NO, "ANSWER” IS INCORRECT. TRY ANOTHER COMBINATION . ;• 

Ej 

F 1 ; Response for the third FAIL. 

W SORRY ’ a STYLE WRONG. BOTH HAPPEN TO BE 
SO-CALLED r "WARM" • COLORS. TRY ONCE 
MORE. j 

J RUBENS: 

E; Response for fourth FAIL. 

W YOU SHOULD HAVE ANSWERED ' "RED AND YELLOW. " * ; 

TITIAN: WHAT ARE THE '■"PRIMARY"' COLORS?; 

etc. 

The numeric expression used as an MFB counter doesn't have 
to be a simple integer; it can he an expression such as 
"N" — 4 - "Y". In such a case the system makes the necessary 
retrievals and/or computations to establish the actual number 
of times the M or F or B statement will he allowed to operate. 
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NOTE or N 



Oftentimes the programmer will want 
to make a permanent or semi -permanent 
memorandum of his reasons for coding 
a sequence in a particular way, or to indicate a transition, 
or to relate sections of code to topical headings in the author/ 
instructor's outline. He wants these memoranda to reappear 
automatically in the program listing whenever it is recompiled, 
without, however, affecting execution in any way. 

The NOTE statement does this. It is completely inert as 
far as the program is concerned, and its only function is to 
preserve and reiterate, in the OBJECT listings, whatever the 
programmer has placed in its operand. 

Statement N STARTING DRILL AND PRACTICE IN PARSING; 

Result N STARTING DRILL AND PRACTICE IN PARSING; 

is printed in the OBJECT listing, in its 
proper location, with a statement number 
assigned. 

NOTE is seldom labelled, because there is not much point 
in accessing a statement that does nothing. Occasionally, 
however, there arises a need to assign two labels to a single 
statement. Since current implementation does not permit this, 
one of the labels can be assigned to a NOTE statement, which 
is placed immediately ahead of the statement in question. On 
execution, if that label is JUMPed to, processing simply goes 
on to the next statement. 

Statements 



J REVIEW37; 



J DICTUM37; 



REVIEW37: N; 

DICTUM37: W THE FOLLOWING TRENDS IN THE TRANS- 
PORTATION INDUSTRY . . .eta... J 
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Result 



(of either JUMP) 



THE FOLLOWING TRENDS IN THE 
TRANSPORTATION INDUSTRY. . . 

etc . . . 



NOTE can also be used temporarily to suppress a statement 
(together with all statements which depend on it). This is 
sometimes desirable when the programmer wishes to enter certain 
items in the program but to keep them in abeyance as far as 
execution is concerned. He can imbed this material in his 
source deck and see it printed out in the OBJECT listing, and 
yet be sure it won’t be executed, simply by adding NOTE or N 
ahead of the statement to be suppressed (but following its 
label, if any). This has the effect of turning the opcode of 
that statement into operand material, which will be (because of 
the N opcode) completely disregarded during execution. 

When the programmer is ready to activate the statement in a 
subsequent compilation, he simply removes the N opcode. 

The device is made the more convenient if statements are 
always punched with a few extra columns preceding the (normal) 
opcode, in addition to those needed for labels. 



Statement (as normally punched) 




( execution suppressed) 
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PART III - PROGRAMMING IN DISCUS 



IDENTIFYING THE The functions performed by the several 

PROGRAMMER DISCUS statements as described in PART II 

need to be thought of as tools by mbans of 
which the craftsman may be able to shape satisfactory computer-assisted 
dialogue. Like any precision tools * they need to be used deftly, and 
in a number of different combinations, in order to achieve a desired result. 

At this point we should pause to consider who will be using these 
tools. Will he be a professional programmer , one already trained in 
some standard computer language, perhaps several? Will he undertake 
DISCUS programming simply as an extension of his repertoire? 

Or will he, instead, be a person whose main commitment is to 
education or training in an academic, commercial, or industrial 
environment? If so, will the production of course materials for 
direct implementation be his principal concern, or will he be 
oriented more toward research and development in the educational 
and training processes themselves? 

Will he be a specialist in some subject field, one who works 
in an educational environment, perhaps, but whose time and energies 
are largely preoccupied by the demands of his specialty? Might 
such a person take up CAI programming in order "bo promulgate his 
specialty more effectively? 

Might the DISCUS user be one whose interests and duties combine 
elements of all the foregoing in a pattern that is unique to him alone? 

In trying to identify and characterize the CAI programmer in 
standard terms, we find that no one set of qualities, interests, 
and objectives suffices. Between the extremes of the. systems 
programmer, on the one hand, and the preoccupied scholar, on the 
other, there will be many who will find CAI programming a useful 
adjunct to their other talents. In addition there will be some 
who will take it up as their exclusive activity. We expect that 
the latter will cluster largely in the educational specialist sector, 
but this may not always hold true. 
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It is difficult to conceive of an individual at either extreme 
who would "be both willing and able to produce, unaided, instruc- 
tional material of suitable quality. In "The CAI Author/Instructor ” 
Meredith discusses the effect on CAI of the essential dichotomy 
between educational substance and educational tools. He postulates 
a role for the subject specialist wherein that individual need not 
master the technicalities of computer programming. By implication 
the CAI "programmer/ instructor" would be the other half of a pair 
of specialists sharing a single educational task. 

Whether one accepts this approach, or adheres to the belief 
that one should merge all functions of the author/instructor and 
of the programmer/instructor in a single person, the functions 
themselves can be considered separately, and in the following pages 
we speak of them in this sense - as functions. We personify them 
separately, for the sake of clarity and convenience, but not to 
imply that only a team approach will work. The reader can decide 
for himself whether he wants to be both members of the team. Mani- 
festly this Manual is limited to dealing with the programming 

function except insofar as it is necessary to speak of its relation- 
ship to the authorship function. 



CAI AS A PRODUCT We have spoken of DISCUS statements as 

precision tools which the CAI programmer 
uses to shape satisfactory computer- 
assisted dialog. The product, in his case is nothing as graphic 
and self-evident as a watch or a painting or even a piece of music. 
The programmer deals with ideas and processes in a heuristic way; 
the results are not immediately evident . His product is only a 
plan of idea-transitions; it is protean and probablistic , a plan 
of happenings many of which may never happen. 



SATISFACTORY COM- What is meant by "satisfactory eomputer- 

FUTER ASSISTED . ^ ^ „ . , „ ^ ^ 

DIALOG assisted dialog? Satisfactory to whom? 

In a CAI context, we feel that both 

the student and the author /in struct or need to feel that they are 



veil served by the computer as a means of communi cation between 
them, bearing in mind that dis junctures of time and place might 
otherwise prevent communication altogether. The author /instructor 
needs to be reassured that his statements will not - in the con- 
volutions of the dialog - somehow be turned topsy-turvy. The 
student needs to be able to convince himself that somewhere a 
human, however remote, is attempting to reach him as an individual. 
Both need to be willing to forego the exquisite controls and bal- 
ances which govern the flow of live conversation, and which on 
reflection they would be unwilling to endow a machine with in 
any case. 

Computer-assisted dialog is "directed dialog,” with almost 
all of the direction in the hands of the author/instructor and the 
programer/instructor . This in itself is not a bad thing: students 

are used to being lectured at , not with , and even seminars have a 
topic of some kind, and a leader. In highly interactive CAI the 
sharing of some measure of direction is entirely feasible, and 
eventually - as programs increase in number, versatility, and 
general availability, perhaps to the extent of coalescing into 
huge learning complexes - much of the supervision of directed dialog 
will pass to the person seated at the student console. 



PROGRAMMING AS We have purposely omitted the program- 

AN EXERCISE IN . 

ANONYMITY mmg function from the above cri- 

terion of satisfactory computer- 
assisted dialog, because the programming function facilitates, 
rather than judges, the final result. He is a communicator, rather 
than a communicant. He has the responsibility of determining how 
well the author/instructor and the student are served, according 
to the system’s capabilities as he sees them. He decides not only 
whether a certain thing can be done, but also whether it will be 
useful enough to either of his patrons to make it worth doing. 

There is, after all, a limit to available programming effort. 
The time spent in making one frame super-elegant may lead to the 
slighting of others, to the detriment of the sequence as a whole. 

On the other hand, it may lead to the discovery of contrivances 




which will he useful in a number of frames. Accordingly, when a 
programmer devotes many hours to a particular subroutine for a 
particular frame, he has, or should have, some expectation of 
being able to use it in other frames as well, with adjustments 
that will be minor and preferably automatic* 

As far as the author/instructor is concerned, the programmer 
speaks for the system hardware, offering a mixed collection of 
services* These are usually far greater in scope than the 
author /instructor who is new to the field will have envisaged or 
will be prepared to utilize. It is essential that they not be 
dragged in just for the sake of using them as toys. On the other 
hand, the author/ instruct or should be reminded from time to time 
that they are there . 

As far as the student is concerned, system mechanisms should 
be as unobtrusive as possible, in order to permit the level of 
communication we seek. Whatever the system conveys to him is 
conveyed on behalf of the author /ins true tor . The programmer, 
as part of the system, keeps well out of sight. He avoids imposing 
more than an absolute minimum of housekeeping chores on the student. 

He busies himself between the two principals, a collaborator of 
the one and an observer of the other. He is there, but like the 
ne'er-do-well father who shows up unexpectedly at his son’s fine 
wedding, he shouldn't rush in and shake hands all around. 

PREPARATIONS A level of mutual understanding should 

join the author /instructor and the pro- 
grammer/instructor, so that the former 
will have a good grasp of system capabilities and the latter 
will have a good grasp of the subject to be taught* Before the 
actual writing of a program is begun, a number of parameters 
need to be specified, or at least described closely enough so that 
collaborators will not find themselves drifting apart later on* 

It is best that this be done in writing. No informal under- 
standing, however agreeable to both parties, can properly sub- 
stitute for written instructions. Even if both functions are undertaken 





by a single individual, he should carefully profile his intended 
student set, course objectives, subject matter, and strategy - in 
advance and in writing. The following checklist may be useful in 
this connection: 

Define the course objectives . 

What is expected to be the students r median age? 

” " n " n " " academic level? 

n n rf n ff ff r preparation 

and/or screening? 

How is the subject matter convenvionally organized 
and presented? 

What are its boundaries? 

What is the nature of adjacent subject matter * and 
how permeable are the inter-subject boundaries? 

The general plan of organization . Witt the 
instruction be sandwiched between lectures or tabs? 

What wilt be the policy on the handling of requests 
for review. Should review consist of iteration y re- 
statement 3 compression * or a combination of alt three? 

What wilt be the policy on the handling of requests 
beyond the scope or depth of the " involuntary stream . " 
If voluntary digressions are permitted y where and how 
are they to be brought back to the mainstream? 

What will be the policy governing sequencing of topics 
or the resumption of topics on n restart " (i.e.^ when 
the student signs back onto the terminal after an 
interruption) ? 

What elements are to be the subject of scoring? 

What statistical data need to be accumulated? 



CORPUS' Next, the author/ instruct or should 

furnish the programmer /instruct or 
(or the author /instruct or /programmer 
should furnish himself) with a body of substantive instructional 
material (corpus) which - if not covering the entire course - will 
at least be complete and well polished as far aB it goes : 
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A list of textual statements to be used . 

A list of questions or requirements de- 
signed to elicit responses from the student . 

A list of anticipated responses according 
to key words (e.g., a topical response 
wi th key word (s) underline d . ) 

A list of conditional rejoinders (not 
necessarily complete because not all 
reasonable responses can be imagined by 
the person who generates the text; the 
programmer himself should be able to 
suggest additional possibilities .) 

This is the heart of the dialog. Its preparation is somewhat more 
demanding than would he the writing of an effective, publishable 
textbook. It should be as explicit as possible before the pro- 
grammer picks up his tools. There will be revisions, of course, 
after the author/instructor develops an ear for computer-assisted 
dialog. Hopefully some of the initial frames can be implemented 
in the system for just this purpose. But without written bases as 
points of departure for such revisions , the programmer will find 
himself floundering in a morass of "Who said what? Where am I?" 



In order for the system to serve both educator and student 
satisfactorily, certain favorable conditions must be established 
at the terminal: 

The student needs to learn to use the equipment as quickly 
and with as little fuss as possible. After being told how to 
sign on and off and how to send his responses to the computer, he 
should - insofar as possible - be freed of the mechanical imper- 
atives which tend to intrude between him and the course material. 

There appear to be two levels of instruction involved here: 
instruction on how to use the terminal, as above, and instruction 
on how to formulate input. An example of the former would be the 
imparting of the method of backspacing over mistakes , something 
the student should be told by pre- instruction . The latter 



represents some inherent constraint or artificiality in the pro- 
gram itself, such as might prevent input from being "under snood, " 
To illustrate this , suppose we had the following display: 

THE "STATUTE OF FRAUDS" IS PRIMARILY CONCERNED WITH 

1. TRANSACTIONS IN JEWELRY 

2. STOCK AND BOND SALES 

3. REAL ESTATE TRANSFERS AND LEASES 
U. THE 'USED CAR RACKET' 



Suppose that for some reason the system or the CAI language in 
use, or both, imposed one or more of the following rules: 

ANSWER ONLY WITH NUMERALS 

ANSWER ONLY WITH NUMERALS OR A SINGLE KEYWORD 
ANSWER WITHOUT ANY SPELLING ERRORS 
ANSWER WITHOUT REVISING SYNTAX IN ANY WAY 
DON'T SUBSTITUTE 'THE FIRST' or 'ONE' for '1', etc. 

DON'T USE DOUBLE BLANKS 

DON'T ANSWER WITH MORE THAN ONE OF THE CHOICES 
DON'T USE MORE THAN 8 CHARACTERS IN YOUR ANSWER 
DON'T COMPLAIN OR ASK QUESTIONS 
DON'T . . .etc. 

How much of this sort of thing should be inflicted on the 
student before he has a chance to answer the question? The best 
solution is to eliminate the constraint , but there will be times 
when the programmer will feel that the likelihood of deviant 
response in a particular frame is so slim that it is not worth the 
labor of accommodating it. It appears to us that this sort of de- 
cision should be reflected in post- instruction . There is no point 
in telling the student ANSWER WITH NUMERALS ONLY if that is what 
he was going to do anyway. The system intrudes much less if it 
corrects and instructs only when an item of student input shows 
that correction and instruction is necessary. 
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The- cfh02.ee between pr e-"Tistznction and post-instruction de- 
pends on tilt? exigencies each particular frame hut the norms in flu 
encimg mess chnices she — ’ 1 he agreed in advance between the author/ 
instructor end the programmer . If the latter worts in a CAI 
language as agile as DISCI , the policy can in fact be one which 
abjures pre-Ln struct ion altogether, or almost altogether. One can, 
in other words , eliminate from the phrase "directed dialogue" 
the connotation of directing the form in which the student answers 
must be couched ±n order to be processed by the system. 



The presentation of instructional material in ways that per- 
mit the student to take an active part in his own learning pro- 
cess is an art in itself. It is not enough to pause every few 
sentences to ask a question merely to find out if the student has 
read and understood what he has been told; the student should be 
enabled to ecctend or exemplify the concept in some small way. 

This means stretching the system to the limit in order to cope 
with a very broad range of responses. When the types of response 
elicited by the author/instructor threaten to exceed this limit, 



e.g.j when the proportion of unanticipated, or fail-match respon- 
ses would be excessively Lugh, he should be so advised. 



It is useful to categorize possible student answers along 
the following lines as a basis for assessing the performance of 



a given set of SCAN specifications: 
A^ (Answer, Legal) 

A (Answer, Illegal) 

A LP (Answer, Legal, Perceived 



A string of student input 
of limited length, con- 
taining at least one term 
relevant to the question 
or its context, and in 
grammatical order. 

Any string of student 
input not meeting the 
above requirement. 

Any A which is pre- 
dicted as possible input. 



iL (Answer, Legal, Perceived, 
Matched) 



Any A--, which the author/ 

J_iir 

instructor chooses to deal 
with specifically. 



"^LPF 



(Answer, Legal, Perceived., 
Failed) 



Any A^p which the author 
deems so remote or so 
inconsequential or so 
difficult to deal with 
uniquely that it should 
he failed. 



^.U 



(Answer, Legal, Unperceived) 



Any A^ not perceived as 
a possibility. 



F 



(The sum of failed Answers) 



A I + + ^LPF 



The type of answer which principally occupies our attention 
is A^p^« It is not necessary that the author or programmer 
have in mind everything that the student might say embodying the 
A^p^ element(s); it necessary that he select some elements 
which are 

likely to match with a broad range of responses relevant 
to a question, 

will match members of semantically similar input, and 

will distinguish semantically dissimilar input by failing 
to match with it. 

The range of A^p^ is directly influenced by the form of the 
questions which precede them. A question posing a very rigid 
requirement (e.g., True-False) reduces the number of A^p^ to a 
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minimum, but at the same blue: it vitiates the conversational mode. 

The goal should be to ops: up questions and to give the student as 

much freedom in formulating bis responses as we can, without 

letting match probability fall below acceptable levels. 

Part of the autior/ insrruct or 1 s task- is to define, or at 

least coherently be describe, the A which he wishes to inter- 
ior 

cept.. The SCANs that are to accomplish this call for close 
collaborative effort on the part of both the author/instructor 
and the programmer, the former contributing most (but not all) of* 
the lexical strategy, and the latter contributing most (but not all) 
of the mechanical tactic. 

In the selection of a single keyword to be specified in a 
SCAN statement, we naturally want to choose one which will, if 
present, almost certainly indicate that the student has expressed 
a particular meaning to which we can respond unequivocally. If 
there appears to be excessive risk in relying on a single keyword, 
i.e., if the word might reasonably be used by the student in a way 
different from that to which we want to respond, we try to restrict 
it somehow by combining it with one or more additional words. 

While this increases the confidence level in respect to the pro- 
gram’s understanding of that which it intercepts, it decreases the 
versatility of that one SCAN parameter * insofar as intercepting var- 
iant expressions of the same meaning is concerned. 

This effect approaches the absolute when one specifies the 
key-string as a literal, ruling out "match" if the student inserts 
or omits anything at all (even an extra blank or two) between the 
specified elements. Thus 

SC 9 RED* WHITE * AND BLUE 9 ; 

would not intercept 

red, white, pink and blue 
or 

red, white, blue 

or even 

red, white and blue 

Such rigidity may be exactly what is wanted sometimes, of 
course, but more commonly literals are used to specify parts of 




keywords rather than longer strings, their function "being to 
afford some latitude in spelling, syntax, etc. Thus 

SC f STOR r ; 

accepts storage , storing , stores , storable a store , etc. (and 
stork, stormy. Storting too, but these are remote enough to be 
acceptable risks.) 

Literals aside, it might be said that for each word specified 
in conjunction with a keyword, the likelihood of misinterpretation 
decreases very rapidly, whereas the likelihood of missing identical 
or nearly identical meanings increases by a similar factor. But 
this should not be construed other than as a gross representation of 
a whole series of effects and counter-effects tied to the probabilities 
of the English language. Input varies in length, and one might ask 
to what extent a long input string would be more likely to contain 
a given key-string than a short one. Perhaps none at all. 

Not all associative words used with keywords carry the same 
discriminatory power. In fact, one finds that sometimes the words 
which are the most obviously associative carry no more certitude of 
correct interpretation when combined with the keyword than do those 
which (syntactically, at least) appear to be more remote yet which 
encompass a better range of variance. Thus it is possible to expand 
the key-string with elements which will greatly strengthen it, 
without entailing loss of versatility in anything like the same ratio. 

Fortunately, one need not rely on a single keyword of key- 
string to intercept a single meaning: the use of TT or-connected T1 

suboperands in the SCAN statement permits a diverse approach, with 
each suboperand attacking the problem from a different angle. 
(Presumably the program reaction to any one of a group of TT or TT -ed 
sub operands in a single statement is intended to be the same. 

Otherwise, they should be set up in separate SCAN statements and 
dealt with uniquely.) 

The f! and"-connected suboperand is really not much different 
from the multiple-word, or key-string, operand discussed above, 
the only difference being that its elements will match input of 
the same elements in any order. Where 

SCAN RED WHITE BLUE; 



101 



will match input containing those three words in that order 
(e.g. , roses are red, snow is white, and violets are blue ) it 
will not match input containing them in any other order (e.g., 

I have a blue hat with red and white streamers . ) But 

SCAN RED & WHITE & BLUE ; will. 

"And"ed suboperands are more rigid than single keywords , but 
obviously less rigid than ordered keystrings , because they do 
permit inversions and permutations* Since content rather than form 
is usually the chief desideratum, this kind of SCAN becomes quite 
useful, even if at the time it is chosen neither the author nor the 
progr amm er have in mind all the forms it might intercept. 

Another feature of the "and” ed suboperand is that it allows one 
to negate any parameter without negating the whole, as happens 
in a simple key-string if one assigned — i to any of its parts. 

Statement SCAN ~i OSCAR STRAUSS ; or SCAN OSCAR -i STRAUSS 

Hesuj t The M not M -sign negates both Oscar and Strauss . 

If we merely wanted to intercept any Strauss other than Oscar , we 
would specify 

SCAN -i OSCAR & STRAUSS ; or 

SCAN STRAUSS & -i OSCAR ; 

"And"ed and "or"ed suboperands let us specify SCAN parameters 
with great precision without forfeiting the degree of open-ness , 
or flexibility, which we require in a given situation. Coupled 
with the "not 11 facility ( -1 ) and the use of stepped or conditional 
SCANS we find that we can interpret student input very accurately 
indeed. 

In the absence of a "not" facility one can accomplish some 
of the same effects by erecting screens which scan for unwanted 
elements first, before scanning for wanted elements. Using the 
OSCAR STRAUSS example, above, one would scan separately for 
OSCAR, ahead of the STRAUSS scan, and if the former is found, jump 
over the latter. 
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WALTZ: 



SC OSCAR ; 

M; 

J WALTZ ; 

E; 

SC STRAUSS i 

M; 

W YES. ; 

J NEXTFR ; 

E; 

SC STRAUSS ; 

M; 

W M?, NOT OSCAR STRAUSS. ; 
J NEXTFR ; 

E; 



There are two ways in which DISCUS permits us to improve on 
this , © one using the "not” facility (for the case where we 
don’t want to make a point of telling the student that Oscar is 
wrong) , the other ® using stepped SCANS: 

(T) SC — » OSCAR & STRAUSS ; 

M; 

W YES. ; 

J NEXTFR ; 

E; 



® 

SC STRAUSS 
M; 

SC OSCAR ; 

M; 

W NO 3 NOT OSCAR. ; 
J NEXTFR ; 

E; 

W YES i 
J NEXTFR ; 

E; 



( diagrammed as : ) 
SC M 



SC 



(F) 

M _ (F) E W J 



W J 



B represents an extremely effective way of dealing with 
faulty answers, because it can cover errors of omission as well as 
errors of commission, simply by using a FAIL block instead of a 
MATCH block. Suppose we wanted OSCAR STRAUSS: 



O 
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SC STRAUSS 
Mi 

SC OSCAR 
Pi 

W TOC/ DIDN r T SPECIFY OSCAR 
STRAUSS . 

J NEXTFR 

E; 

W CORRECT 9 : 9 OSCAR STRAUSS . 
J NEXTFR 
E; 



M 



SC 



LPl E 

F (M) E W J 

W J 



+ 



Block structure moreover permits one to scan for the same 
word more than once in the same frame without the constraint 
that the first such SCAN is the only one that will succeed. 

As indicated earlier, TEST and SCAN are much alike. Both 
govern decisions in block structures, but whereas TEST may be 
satisfied according to its terms by a logical relationship 
(>, — - , = , or <) of the whole variable tested, SCAN requires 
equality, but only in the part specified. Also while the con- 
tents of any variable may be TESTed, only the contents of the 
ANSWER variable may be SCANned. 

TEST is relied on for most of the housekeeping chores involved 
in careful CAI programming . Often such functions can be standard- 
ized and tucked away in subroutines, callable by the USE command 
wherever a particular service is required. For example, suppose 
the author/instructor wanted to invoke review sequences when ,T X TT 
reached 10 or "Y" reached 7 or the two together amounted to over 
13; both "X" and "Y” to be incremented whenever the student made 
certain types of errors. The subroutine to accomplish this should 
be USEd at the beginning of each frame, which is the logical 
breakaway point for any review. (Note that we use a block struc- 
ture to USE several statements together. )* 



^Assume T, X M , ,f Y", and "Z" have been defined as arithmetic 
variables, and REVY is the label of a review sequence. 
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FR; 

U REVIEWA ; 

W (ongoing text); 



REVTEWA: B; 

T "X" > = 10; 

M; 

U NOTIFY; 

J REVY; 

E; 

T "y" > = 7; 

M; 

U NOTIFY; 

J REVY; 

E; 

S "z" = "X" + "Y"; 

T "z" > = 13; 

M; 

U NOTIFY; 

J REVY; 

E; 

NOTIFY: W I THINK A SHORT REVIEW WOULD 

BE GOOD AT THIS POINT . ; 

E; 

(Observe that the statement labelled NOTIFY never executes sequen- 
tially, because it follows a JUMP at the same level. An alternate 
treatment would be to substitute it for one of the U NOTIFY 
statements . ) 



3 
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Suppose the author wanted to prevent repeating exactly the 
same review sequence (REVY, in the example) in the case of a 
student who continues to have difficulty. One solution would he 
to furnish a control along the following lines : (Added state- 

ments are indicated hy arrows).* 



REVIEWB : B; 

T "X" > =10; 

M; 

U NOTIFY; 

T "REVYX" = 1; 
M; 

J REVY2 ; 

E; 

S "REVYX" = 1; 

J REVY; 

E; 

T "x" > =7; 

M; 

U NOTIFY; 

T "REVYX" = 1; 
M; 

J REVY2 ; 

E; 

S "REVYX" = 1; 
J REVY; 



T "Z" > = 13; 
M 



U NOTIFY; 

T "REVYX" = 1; 

M; 



* Assume "X" , "Y", and "Z" and "REVYX" have been defined as 
arithmetic variables. 

(REVY and REVY 2 are labels of the two review sequences.) 
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J REVY2; 



E; 

S "REVYX" = 1; 

J REVY; 

NOTIFY: W I THINK A SHORT REVIEW WOULD 

BE GOOD AT THIS POINT.; 

E; 

E; 

It should immediately be apparent that the added statements 
comprise three identical groups 3 which might be written as a 
separate subroutine (or 1 sub-subroutine ' If you like) and USEd 
when needed: 





REVYZ : B ; 




T "REVYX" = 1; 




M; 




J REVY2 ; 








S "REVYX" = 1; 




E; 





USEable subroutine 
block 



N/ 




FR; 

U REVIEWA; 

W (ongoing text); 

REVIEWA: B; 

T M X > - 10; 

M; 

U NOTIFY; 

U REVYZ ; 

J REVY; 

E; 

T Tf Y ,f >= 7; 

M; 

U NOTIFY: 

U REVYZ; 

J REVY; 




E; 



s "z" = "x" + 

T "Z" > = 13; 



tly” 



M; 



U NOTIFY; 

U REVYZ; 

J REVY; 

NOTIFY: W I THINK A SHORT REVIEW WOULD BE 

GOOD AT THIS POINT; 






E; 



E 
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The block of seven statements can he stored away anywhere 
in the program where it will he protected against accidental exe- 
cution, e.g. , after a JUMP. Another appropriate location is any- 
one of the points at which the coder wants to provide for its 
use, where it will naturally take the place of the USE command, 
at the same time it continues to he USEable from other points 
in the program. 

In the above, we have reduced the fifteen statements required 
in the original augmentation (page 91 ) to ten, and have provided 
a subroutine module that will possibly be useful in some other 
context, because KEVYZ is not bound to REVTEWA even though we 
happened to write it as part of that subroutine. It can be 
brought in at any level above the very lowest (250) and function 
quite properly. 

It is axiomatic in programming that one should avoid repeti- 
tive code whenever possible, i.e., when a subroutine can be devised 
that will always and invariably achieve a certain effect when 
called upon. By being alert to the use of subroutines, the 
programmer saves himself considerable drudgery, besides reducing 
the chance of random error (in coding and keypunching) to which 
repetitive coding is susceptible. His program will compile faster 
and occupy less storage space. Execution time will be increased, 
but this is usually a minor point. 

To return to the problem for which the REVIEWA* subroutine 
was suggested as one solution, namely the situation wherein 
the author wants to invoke review sequences whenever the values 
in certain variables reach prescribed levels: 

A second method would be to put TESTs at the head of each 
set of review frames, and poll them in a series of JUMPs. The 
difficulty is that it would be impossible for execution to return 
to the point whence it was diverted, since JUMP is an uncondi- 
tional command. Only USE provides return to the point of ori- 
gin on completion of the frame, block, or statement that is USEd. 

Third, it is possible to nest whole series of frames in 
blocks, entry to which depends on the results of TESTs and SCAHs , 

* 

These labels are all arbitrary and have no special meaning in 
DISCUS . 

-®09 „ 



and this might he a good way to set aside complicated review or 
enrichment routines whose execution would automatically adjust to 
combinations of values in a set of variables. An example of this 
kind of development is not attempted here, however, because it 
would involve excessive supporting detail of no immediate interest. 

It may be asked, in connection with the subroutine REVYZ , worked 
out on page 103, why we needed a subroutine at all, when by simply 
limiting the number of times a MATCH, FAIL, or BLOCK block may be 
entered we might prevent the same review sequence (REVY) from being 
executed twice. Why not encode REVIEWA as follows? 

REVIEWA: B; 

T "X" >= 10; 




NOTIFY : 



M 1; 

U NOTIFY; 

J REVY; 

E; 

M; 

U NOTIFY; 

J REVY2; 

E; 

T "Y" >= 7; 

M 1; 

U NOTIFY; 

J REVY; 

E; 

M; 

U NOTIFY; 

J REVY 2 ; 

E; 

s "z" = "X" + "Y"; 

T "Z" >= 13; 

M 1; 

U NOTIFY; 

J REVY; 

W I THINK A SHORT REVIEW WOULD BE GOOD AT 
THIS POINT. ; 

E; 



E; 
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1. Immediately following each ANSWER statement, insert 

USE UTILITY ; 



2. In a protected location, establish a block of code beginning 
with 

UTILITY: B; 

and ending with 

UTILANS : A; 

E; 

3. Inside the UTILITY block, a series of subroutines may be 
nested as separate modules , to be added to or changed or removed 
as the coding progresses and the exact nature of the service re- 
quired is more fully perceived by the programmer. 

a. To help the student sign off : 



B; 

SC SIGN OFF , QUIT,, TIRED , ' FINI ', ' TERMIN' 

SPLIT, GET OUT , 'M THROUGH ', 'M THRU’, LOG ; 

M; 

W IF YOU WANT TO SIGN OFF NOW, JUST 
TYPE ’’’EXIT"’; 

J UTILANS ; 

E; 

(l) "EXIT" happens to be the sign-off convention in 

use under ILR Berkeley TMS Monitor. At ILR UCLA, 
the equivalent term is "END". 

b. To display the previous statement (often desirable when 
the student has made two or three unsuccessful stabs 
at a question). An arithmetic variable, previously 
established, will have been incremented every time a 
FRAME statement is passed through, e.g., SET "FRCOUNT" — 
"FRCOUNT" + Is) 



SC REPEAT & PREVIOUS, DISPLAY & PREVIOUS, 
CHOICES, AGAIN, ’ FORG ' STATEMENT, 
•FORG’ LIST, SHOW ME, ME SEE, WANT 
SEES 
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There are two errors in this treatment: 

One is that it does not prevent the student from qualifying for 
REVT two times or even three times in a row on the different criteria. 
That is , he could have a total Z of 13 and be jumped to REVY, then a 
total X of 10 and be jumped again to REVY, then a total Y of 7 and 
again be jumped back to the same old review . There is no way of 
grouping the three independent tests in such a way that a single 
limiting MATCH- FAIL-BLOCK- counter will monitor them unless we set up 
a fourth block to test a flag dedicated to this one function - 
which brings us right back to the REVYZ routine (p. 103). 

The other difficulty is that since MFB-counters are reset 
every time execution passes through a FRAME statement, the device 
would work only in the unlikely event that REVY contained no FRs , 
and then only for the duration of the current frame in the main- 



stream of the instruction. 

We can draw a general conclusion from this , namely that the 
MFB-counters are not particularly suited to subroutines intended 



for inter-frame use except for operations strictly internal, t 



appiica 



the subroutines themselves. 

A characteristic which limits a de 
(as above) may be turned to advantage in 
one might want to reset MFB-counters during 
under certain conditions, without having to l|f 
then return. This can be effected by inserting a frame statement 
(FR; ) - which need not be labelled - at any point where the 
MFB-counters are to be reset to zero. 





m s , 

examp 

of a frame 
frame and 



Before the programmer starts writing frames, he will be 
well advised to consider the kinds of utility services that should 
be available more or less continuously during the running of the 
program - services for both the student ! s and his own benefit. 
DISCUS users may be able to adapt to their needs. They should be 
thought of as if they were recipes in a cookbook, which anyone 
is welcome to try. 



M; 

S "ANSWER" = "FRCOUNT * ; 

SC 1; 

M; 

J (label of first frame of main text) ; 
E; 

SC 2; 

M; 

J (label of second frame of main text); 
E; 



E; 

diagrammed as follows : 



I 

SC M 

S 



S£ 



M 



/ 



If first scan 
unsuccessful . 



E_ 



M 






c. To allow student to go back to previous frame: 

B; 

SC GO BACK , PREVIOUS , REPEAT, PRECEDING, 
REVIEW, LAST ; 

M; 

S "BACKUP" = " FRCOUNT ' - 1; 

S " ANSWER " = "BACKUP"; 

U WHERE; 

E; 

E; 



o 
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d. 



To alloy author/ins true tor , programmer, editor, or "debugger" 
to check the status of variables during processing : 



B; 

SC EDITOR 



M; 



(Name 



W EDITOR INFORMATION ' • '/; 

w(nd) ■» v=w f 



of variable, not 
in quote's! 







(Name of same 
^ variable 9 in 
double quotes) 



etc . 

E; 

E; 

e , PROCTOR MODE, to allow programmer, etc., to jump execution 
to another part of the program without using DISCUS system 
author mode 

B; 

SC GO TO', 

M; 

SC (label of FRAME statement at desired 
destination, not in quotes.); 

M; 

J (same label, not in quotes.); 



E; 

W SORRY > UNABLE TO COMPLY . ; * 

E; 

This routine allows one to access topical subdivisions of 
the program according to an outline of the course, keyed with 
program labels corresponding to its various rubrics. It is not 
as precise a method of jumping around in the program as the //F=t 
command affords (see p. 137 ) but is somewhat more convenient for 
the non-programmer. ) 

* This takes care of the unfound label, and of the student who says 
"go to hell. " ) 

-no- 

114 



f . To gather statistical information about student input , 
e.g., common spelling errors 

B; 

SC (word); (or SC (word), (word); 

SC (word) & (word) ; 

SC (word) (word); etc.) 
M; 

S "WORD A" = "WORDA" + 1 } 

E; 

SC (word); (etc.) 

M; 

S "WORDB " = "WORDB " + Ij 
E; 



E 
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STARRED VARIABLES An unusual feature of DISCUS is an 

operation that can he performed on 
a character variable by placing it be- 
tween two asterisks in a SCAN operand * thus 

SC 'V *"VIRIDIUM"*'V' ; 

Instead of the contents of the variable being scanned , as would 
be the case if the statement were written in the usual way: 

SC "VIRIDIWf* ; 

the variable is filled with data from the ANSWER FIELD. 

In order for this to happen, a match must occur between 
something in the answer field and SCAN elements immediately 
preceding and following the starred variable. 
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At present only character variables may he used. 

CAT: D(C) 50; 

W (something); 

A; 

SC ’S' *"CATS" * 'S '; 

The SCAN, operating on an answer field of 'SLIVERS' , for in- 

stance, would obtain a match, and would most assuredly put 
LIVER into "CAT". 

SC ' ' ' ' *"CAT"* ’S ’ ; 

operating on an answer field of 'ARGYLE SOCKS' puts SOCK into 
"CAT". 

SC ’S’ *’’CAT"* ’ ’; 

operating on the same answer field puts OCKS into "CAT". 

In single operands or in ored suboperands , only the first 
suitable ANSWER field gets inserted, because the SCAN operation 
terminates immediately on success . Thus 
SC ’S' *"CAT"* ' ’; 

operating on an answer field of 'SALLY SELLS SEA SHELLS BY THE 
SEA SHORE' matches immediately with VSALLYtf and only ALLY gets 
put into "CAT", not ALLY HELLS EA HORE. 
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PART IV - CONCISE DISCUS SPECIFICATIONS 



SPECIFICATIONS This section of the MANUAL defines the 

basic elements of DISCUS , for lose as 
ready reference and as a recapitulation 
of the material presented in PART II and PART III. As stated 
in the INTRODUCTION, DISCUS is an interpretive man-computer 
interface system, currently implemented as a conversational 
CAI language. It is programmed entirely in assembly language, 
for the IBM 360 series. It is characterized by fast execution, 
economy of core, and ready interface with CRT-oriented time- 
sharing system s. 



ARCHITECTURE 



See block diagram, page 115. 



REQUIREMENTS Source 80-byte card images in 

DISCUS source language. 

Comp’L'lev The program which converts 

DISCUS source code to DISCUS 
OBJECT code. Consists of 
approximately 

8500 bytes of basic assembly language 
2000 ,f for output buffers 

800 ,f for each input buffer 

26 ,f for each unique label 

(symbol) compiled 
2n bytes for print buffers where 
n is the block-size of the 
SYSPRINT data set (see 
page 13^, control card number 

k). 

Executor The program which interprets 
the DISCUS OBJECT data set. 
Consists of approximately 
8500 bytes of executable code 
^900 11 for each individual 

using the system. 



O 
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( REQUT REMEN TS , c ont . ) 



Object Data 

Set The data set into which the 

DISCUS OBJECT text is placed 
by the compiler. The format 
of the object data set is 
DCB= ( RECFM=VB ,BLKSIZE=1000 ) 

Termina l CRT displays which may be 
erased ; 

written from top left corner 
to bottom right corner, with 
a variable number of charac- 
ters ; 

read, from either the top 
left corner to the last data 
byte on the screen, or 
from the first position of 
manually- entered data to the 
last position of manually - 
entered data* Any line from 
2 to 100 bytes in length 
and a total screen of up to 
1100 bytes can be accomo- 
dated. 



CURRENT IMPLEMEN- DISCUS is currently implemented in time- 

TATION 

sharing systems operating under IBM 
OS/360 (Release 17) at the Berkeley and 
Los Angeles campuses of the University of California. Terminal 
equipment in use at these locations, respectively, consists of 
a Sanders 730 CRT System and a CCI 30 CRT System. 




i±8 ' 
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GLOSSARY 



The following definitions correspond -with 
standard meanings for the terms defined, 
qualified to apply to DISCUS . 



Stateme * 


A statement is the smallest cohesive unit 
with which the DISCUS compiler will deal , 
The DISCUS COMPILER accepts statements, 
each of which must contain one and only 
one opcode ( q.v. ) and each of which must 
he terminated by a semicolon as an end-of- 
statement delimiter. A statement usually 
contains an operand ( a.v. ) between the 
opcode and the end-of-statement delimiter. 
A statement may be identified by a label 
(q.v.) which must itself be followed by 
a colon. Thus the format of a DISCUS 
statement is typically: 

LABEL: OPCODE OPERAND; 


Opcode 


A DISCUS OPCODE defines the nature of 
the operation which is to take place. 

If the statement includes an operand, 
at least one blank must be interposed 
between the opcode and the operand. 

If no operand is encoded, the opcode is 
followed by the statement-delimiting 
semicolon, either immediately or with 
one or more blanks interposed. Thus 
the following are all legal: 

OPCODE OPERAND;’ 

OPCODE OPERAND ; 

OPCODE ; 

OPCODE ; 


Operand 


Any of several types of parameter. These 
may be absolute data, symbolic labels, or 
codes peculiar to special operations. The 
OPCODE generally performs an operation 
either on or using an OPERAND. One or 
more blanks may be interposed between the 
end of the OPERAND and the statement - 
delimiting semicolon. (For the effect of 
doing this with a WRITE opcode, see page 
22ff ) Both of the following are legal: 

OPERAND ; 

OPERAND ; 

The OPERAND must always be preceded by at 
least one blank . 



( GLOSSARY 3 cont.) 

Suboperand 



Label 



Word 



Literal 



Character 
String 
Varlab le 



This is a term peculiar to DISCUS , de- 
noting portions of a SCAN operand which 
are logically separated by an ampersand 
(&), ^or-bar 11 (|), or comma. Thus in 
the following: 

SCAN BEANS PEAS, CARROTS & CORN; 
the following constitute suboperands: 

BEANS PEAS , 

CARROTS and 

CORN. 



A LABEL is a character string used to 
identify and locate a statement. In 
the current implementation of DISCUS, 
it may not exceed 8 alphanumeric char- 
acters , of which the first must be alpha- 
betical. It must end with a colon, or 
one or more blanks followed by a colon. 

It must not be broken by blanks. No 
more than one label may be attached to 
a single statement, nor may the same 
label be attached to more than one 
statement . 



A UORD is a string of characters which 
does not include imbedded blanks , special 
characters , or symbols , and which is sur- 
rounded by blanks, either explicit or 
implicit. WORDS used in SCAN statements 
constitute elements against which a user’s 
response may be compared. 



A LITERAL is a string of characters , 
punctuation marks, symbols, and explicit 
blanks , not used in a special code sense. 
In order to be treated as a LITERAL such 
a string must be surrounded by single 
quotation marks. (For use of these marks 
themselves as LITERALS, see example, 
page 26. Inclusion of a character in 
a LITERAL suppresses any special char- 
acteristics which it may normally possess 
in the DISCUS system. 



A CHARACTER STRING VARIABLE is a string 
whose length or content is variable and 
which is accessed by a label. Its con- 
tents may be changed during execution. 



(GLOSSARY, cont.) 





The space for a character string vari- 
able must be pre-established by a sepa- 
rate defining statement. 


Numeric 

Variable 


A NUMERIC VARIABLE is a field intended 
to contain a numerical quantity whose 
magnitude may be changed during execution 
The space for a numerical variable must 
be pre-established by a defining state- 
ment. The contents of a variable are 
accessed by referring to its label. 


Match Block 


A block of code which is entered only if 
a SCAN or TELr immediately preceding it 
has been satisfied. 


Fail Block 


A block of code which is entered only if 
a SCAN or TEST immediately preceding it 
has not been satisfied. 


Vncondi tiona 1 

Block* 


A block of code which is entered regard- 
less of match or fail condition resulting 
from a SCAN or TEST. Entry into an UN- 
CONDITIONAL BLOCK serves to increment the 
existing block level. 


Block Level 


A numerical value (l to 250) assigned 
to individual nested blocks. Thus a 
block within a block which is within a 
block at level 1 will have a block level 
of 3 . 



* Sometimes called the 


"Block block . 1 
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OPCODES The functions of the DISCUS OPCODES 

and their modifiers are defined in 
the pages which follow. Technical 
notes are added in some cases. The order of presentation is 
the same as that used in PART XIX. 



WRITE or W The WRITE opcode (command) causes the 

screen to he written from the top, after 
erasing all previous display material. 

If the number of characters in the statement exceeds screen 
capacity, it will write to the end of the screen and then wait 
until the console-user presses the interrupt button (or other 
designated signal, such as "send page" on the Sanders system). 
This action is treated as a continuation of the WRITE command; 
the screen is erased; and the remainder of the statement is 
displayed . 

End-of-line formatting is automically performed. 



WRITE(NF) or W(NF) This command writes without end-of-line 

formatting . 

WRITE(WD) or W(ND) This command writes without first 

erasing the screen. The characters to 
be displayed are laid down beyond the 
previously-written text . The format or no-format style of the 
preceding WRITE command is continued in the WRITE(WD). 
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ANSWER or A 



The ANSWER OPCODE sets in train the 
following operations: 



1. It causes a carat to be displayed at the beginning of the 
line below the current ly-disp! yed WRITE text, tc invite key- 
board input. The input itself is displayed as typed, without 
disturbing the WRITE display, and without being considered by 
thi- computer until "send" is signalled by the student. 

2. After "send,” ANSWER takes whatever has been typed* and 
puts it in a character variable whose name is "ANSWER." (This 

is not an ordinary label address, but a reserved word, predefined 
in the system.) The ANSWER field can contain as many as 250 
characters, any excess being truncated on the right. A record 
is also kept of the total number of characters present in the 
ANSWER field. 

During a SCAN only 3 in addition to the characters and 
blanks actually input, ANSWER inserts a blank at the beginning 
of the field, and one at the end. Thus the character-count 
is always increased by two. 

At the start of program execution, the ANSWER field contains 
unknown information (usually nothing). Thereafter it contains 
the data recorded there on the occasion of the last "send." 
Whenever a new "send" is signalled, the new input (which 
may also be nothing at all) entirely displaces what was there 
before . 

In order to save the contents of the ANSWER field at a 
particular stage during execution, they must be transferred to 
a defined character variable (see SET, p. 57 ) • Meanwhile, 
however, they can. be scanned successively for various elements. 



*None of the constraints applying to the coding of reserved 
characters (single quotes, double quotes , etc . ) are imposed on 
student input. If the student inputs any of these, they are 
automatically treated as literals. 
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may be quoted in WRITE displayed by imbedding the reserved 
■word "ANSWER" (always in double quotes) in the WRITE operands, 
may be added— to, and may have selected material copied out 
of them through the use of "starred variables" coded in SCAN 
operandx (see p. Ill) • 
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ANSWER (NF) or A(NF) 



This opcode Sanctions in exactly the 
same way as ANSWER, except that instead 
of placing a carat and cursor at the 
beginning of the line below the last line of WRITE text, it 
eliminates the carat altogether and places the cursor at the 
end of the WRITE text, or at the end of any elements "supplied" 
to the screen by the ANSWER operand (see p.39). The student 
may back the cursor across such elements in order to fill in 
a blank anywhere in the ANSWER operand. This is illustrated 
in the following example : 

Statement: - WRITE PLEASE SUPPLY THE MISSING WORDS IN THE FOLLOW- 
ING FRAGMENT OF SHAKESPEARE 1 : f / WHEN TO THE 
SESSIONS OF SWEET SILENT / I SUMMON UP; 

A(NF) OF THINGS PAST; 

Display: - 

WHEN TO THE SESSIONS OF 

SWEET SILENT 

I SUMMON UP 

OF THINGS PAST_ 

Confronted with this display, the student would 
be able to move the cursor back as shown below , 
overwrite the solid line, and have his input con- 
sidered as part of the ANSWER field: 

Display: - 

WHEN TO THE SESSIONS OF 

SWEET SILENT 

I SUMMON UP 

OF THINGS PAST 

He could move the cursor further back, i.e. , 
into the block of WRITE text, but his input will 
not be seen by the ANSWER statement. Accordingly, 
the example represents a poor formulation. Cor- 
rectly encoded, the ANSWER operand should have 
been written 

Statement: - A(NF) I SUMMON UP OF 

THINGS PAST. } 
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SCAN or SC 



SCAN searches the ANSWER field for ele 
ments specified in its ovn operand. 
These elements may consist of words , 
strings of words, single characters, numerals, punctuation 
marks (coded as literals) and blanks (also coded as literals). 

A string containing a combination of words , blanks , punctuation 
marks, etc., if it is to be sought in exactly the same form as 
that in which it appears in the SCAN operand, needs to be speci- 
fied as a literal in its entirety by surrounding it with single 
quotes. If intervening words in the ANSWER field are acceptable, 
the string should not be specified as a literal. 



Statement 

Result 



Statement 

Result 



SCAN SODIUM CALCIUM; 

The ANSWER field will be searched for two 
separate words , sodium and calcium , in that 
order s 

SCAN ’SODIUM CALCIUM, 1 ; 

The ANSWER field will be searched for the 
two words in that order, separated by a 
single blank and followed by a comma. 



Success full match of a SCAN specification against some part 
of the ANSWER field is reflected by the setting of a condition 
code to tT match ” . Failure sets the condition code to tT fail I T . 

The SCAN operand can be divided into two or more sub-operands 
each of which is compared (in the order of their specification) 
against the contents of the ANSWER field until a specified com- 
bination succeeds , at which time the condition code is set to 
"match”, scanning ceases, and processing jumps to the next 
statement . 

Suboperands are separated from each other by commas, or 
”OR"-bars ( j ) , both of which act as "or” logical operators , or 
by ampersands, which serve as "and" logical operators. 

Statement SCAN SODIUM, CALCIUM; 

Result The ANSWER field will be searched first for 

SODIUM. If found, the condition code will 
be set to ” match” and execution will jump 
to the next statement beyond the delimiting 
semicolon. If not found, the ANSWER field 
will be searched for CALCIUM. 
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Statement 



SCAN SODIUM & CALCIUM: 



The ANSWER field will be searched first for 
SODIUM, then for CALCIUM. The ’match" con- 
dition code will be set only when both are 
found. The order in which the two appear 
in the ANSWER field will not affect the result. 



When it is desired that the ANSWER field will be searched 
for elements which will match the contents of some variable, 

latter can be specified in the SCAN operator simply by re- 
ferring to the variable's label address, in double quotes. 



Statement 

Result 



Statement 



Result 



SCAN "CHEMICAL"; 

If CHEMICAL is the label of a character 
variable containing - say - PHOSPHATE, then 
PHOSPHATE is the word which will be com- 
pared against the ANSWER field, as it were 
another literal. 

If CHEMICAL is an arithmetic variable, the 
numerals making up its contents are treated 
as characters, in a literal string. Combi- 
nations of letters , words , blanks , punctuation 
marks, etc., in a variable's operand are al- 
ways treated as a single literal string when 
expanded into a SCAN operand in this way. 

(Assume CHEMICAL contains PHOSPHATE, SULPHATE) 
SCAN "CHEMICAL"; 

Equivalent to that of 
SCAN 'PHOSPHATE, SULPHATE T ; 



In the current implementation of DISCUS there is no way of 
activating, in a SCAN operand, commas or ampersands fetched from 
a variable. Thus the contents of a variable m us t always be 
scanned for in their entirety, as a literal, rather than as a 
group of suboperands. 

A third logical operator usable in a SCAN operand is the 
"not" sign (~i) . It has the effect of negating all elements in 
the sub operand in which it appears , 



Statement 

Result 



SCAN -i CAT; 

Any ANSWER field which does not contain 
CAT will be matched. 
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Statement 


SCAN CAT -i MOUSE; or SCAN -> CAT MOUSE; 


Result 


Any ANSWER field which contains neither CAT 
nor MOUSE will be matched. 


Statement 


SCAN CAT & -i MOUSE ; 


Result 


An ANSWER field containing CAT but not MOUSE 
will be matched, since the — \ does not apply 
to the cat sub operand. 


Statement 


SCAN CAT, ■— i MOUSE; 


Result 


The ANSWER field will be searched first for 
CAT. If successful, the operation will ter- 
minate without checking for — i MOUSE. If un- . 
successful, the ANSWER field will be searched 
for — i MOUSE, and if no MOUSE is found a match 
condition will be set. 


Statement 


SCAN MOUSE, CAT; 


Result 


The ANSWER field will be searched first for 
MOUSE. If no MOUSE is found, a match con- 
dition will be set and execution will jump 
over the CAT suboperand. If a MOUSE found, 

scanning will continue to the second suboperand 



By scanning for parts of words as literals it is possible 
to obtain matches against misspelled words, in many cases. For 
such purposes the literal for a word-beginning must include the 
starting blank, the literal for a word-ending must include the 
ending blank, and the literal for a possible word-middle should 
include no blanks at all. 



Statement 


SCAN 1 DOD ! ; 


Result 


A match will be obtained if the ANSWER field 
contains any word beginning T DOD... T 


Statement 


SCAN ' DRON 1 ; 


Result 


A match will be obtained if the ANSWER field 
contains any word ending with ' ...DRON' 


Statement 


SCAN 1 CAH ' ; 


Result 


A match will be obtained if the ANSWER field 
contains any word containing that combination. 




All three will succeed with DODECAHEDRON, 
for example. 
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DEFINE or D DEFINE statements are used to establish, 

without initializing, the variables to 
be used In. a particular DISCUS program. 
In each case the DEFINE opcode must be qualified in such a way 
as to establish whether the variable is to be used to contain 
mathematical data or characters: 

DEFINE( A) or D(A) - arithmetic 

DEFINE ( C ) or D(C) - character 

In addition, the maximum length in number of characters 
(up to 250) must be specified for D(C), in order for the com- 
piler to reserve adequate space for planned content. 

DEFINE statement are always labelled, otherwise the 
variables which had been created would not be accessible. 

Topical defining statements of each type would be: 

ADDO: D(A); 

CHAR: D(C) 100; 
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SET or S 



SET or S 


The SET statement is used to initialize. 




alter, or clear the contents of a var- 




iable. The SET operand always contains 



three elements: an objective variable (to the left of an equal 
sign), the equal sign itself, and the material with which the 
variable is to be equated. Names of variables specified in SET' 
operands are always separately surrounded by double quotes . Let 
us assume "EINSTEIN" and "RELATIVE" are arithmetic variables. 



Statement 


SET "EINSTEIN" = "RELATIVE"; 


Result 


Whatever the contents of RELATIVE may be now- 
become the sole contents of EINSTEIN. 


St at ement 


SET "EINSTEIN" = "EINSTEIN" + "RELATIVE"; 


Result 


EINSTEIN now contains its prior content plus 
the contents of RELATIVE. 




RELATIVE is unaffected in both cases . 



The hind of variable (i.e., arithmetic or character) which 
is the object of the operation, and which is always named immedi- 
ately after the opcode, determines whether the operation will be 
arithmetical or character-manipulative. 



Statement 

Result 


SET "ADLO" = 2 + 2 ; 

If ALDO has been defined through a D(A) , it 
will now contain U. 


Statement 

Result 


SET "CHAT" * *2 + 2 T ; 

If CHAT has been defined through a D(C), it 
will now contain the literal 2+2 (2#+#2). 



Words or strings placed in character variables must be speci- 
fied as literals, as above. Otherwise the operation will fail, or 
have unspecified results. 



Statement 


SET "CHAT" ~ 2 + 2; 


Result 


CHAT is set to null. 



If an attempt is made to place a character variable in an 
arithmetic variable, numerals and operators will be dealt with 
arithmetically, but all other characters will be converted to 
zero and disregarded. 
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Statement 

Result 



SET "ADDO" = 1 20 QUESTIONS’; 
ADDO will contain the number 20. 



The presence or absence of blanks outside of integers and 
literals in any SET operand is immaterial. 



Statements 


SET 


"ADDO" 




128786+4 ; 




SET 


"ADDO" 


= 


128786 + 4 ; 


Result 


The 


same . 






St at ements 


SET 


"CHAT" 




'A' r B ' 'C' 'V ' ,D' 




SET 


"CHAT" 


= 


' ABCfe ,D' ; 


Result 


The 


same . 






The contents 


of a variable may be altered directly, as in 




SET 


"ADDO" 




hi 




SET 


"CHAT" 


= 


’ HELLO , THERE ! ’ ; 


or indirectly, as 


in 










SET 


"ADDO" 




"MATH" ; 




SET 


"CHAT" 


- 


"VERBOSE" ; 



A character object variable is always set to the concati- 
nated result of the expanded variables and the literals on the 
right side of the equal sign. Arithmetic variables are expanded 
and converted to character string equivalents before processing. 

One or more arithmetic operations may be performed on the 
contents of an arithmetic variable, using the following operators: 



* 

/ 



add 

subtract 

multiply 

divide 

anything else is considered a plus sign. 



Arithmetic expressions are evaluated from left to right, with 

\ 

no hierarchy of operations being observed. All processing is 
in integer arithmetic, and all intermediate fractional results 
are dropped. 

SET "ADDO" = t, MA.TH tt 



Statement 

Result 



+ 10 / 13 + 2 * 5; 

(Assume "MATH” contains 7 ) 

ADDO will be set at 15* 



If the prior contents of ADDO are brought into the operation, 
the sequence of doing so is highly important. The result of 



O 

ERIC 



jL 

- 128 - 



S "ADDO" = "ADDO" + "MATH" + 10 / 13 + 2 * 5 is quite different 



from the result of S "ADDO" = "MATH" +10/ 13 +2*5+ "ADDO" . 

In dealing with character variables, arithmetic operators 
have no effect: 

Statements SET "CHAT" = "VERBOSE" + "PROLIX"; 

SET "CHAT" = "VERBOSE" "PROLIX"; 

Result The same.. The contents of VERBOSE are placed 

in CHAT, followed by the contents of PROLIX. 

(Neither VERBOSE nor PROLIX is affected) 

In order to prevent concatination of elements packed into 
character variables, it is often necessary to specify blanks: 

St atement SET "LIST" = 1 COFFEE f + 'TEA' + 'ROOT BEER'; 

Result LIST will contain COFFEETEAROOT BEER, 



Statements 


SET "LIST" = 


’ COFFEE ' 


'V + 'TEA' + 


+ 






'ROOT BEER' ; or 






SET "LIST" = 


' COFFEEb ' 


' TEAfe ' ' ROOT 


BEER' ; 



Result LIST will contain COFFEE TEA ROOT BEER. 

Both arithmetic and character variables are cleared by omitting 
to specify anything to the right of the equal sign. 

Statement SET "ADDO" = ; or SET "ADDO" = 0; 

Result ADDO will contain zero (0)* 

Statement SET "CHAT" = ; 

Result CHAT will contain nothing. 

While numerical quantities may be subtracted from the 

contents of arithmetic variables , there is no way of subtract- 
ing characters from character variables except by truncation, 
that is, by transferring the entire string to another variable 
which has been so defined that there will not be room enough 
for all the characters, and the excess will be dropped off. 

A character string may be scanned, however, for particular 
elements, after first being transferred to the ANSWER field 
for the purpose. 
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Statements SET " ANSWER" = "CHAT"; 

SC COFEEE; 

Res-nT t If "coffee" appears anywhere as a separate 

word in the string, it will be detected 
and a match condition wild, be set. 



TEST or T The TEST statement compares the contents 

of an object variable (specified to the 
left of a logical operator in the operand) 
with whatever is specified to the right of the operator. TEST 
much resembles SCAN, except that it must always succeed in its 
entirety in order to set the condition code to positive. 

The logical operators \ised in TEST are: 

= equals 

> is greater than 

< is less than 

— i is not ( = , >, and/or <) 



and they may be used singly or in any combination. 
Example 1: T "X" = 4; 

Example 2: T n ALPHA ,? = 'bNOV; 

Example 3: T 



JUMP or J The JUMP statement transfers control 

unconditionally to a statement located 
elsewhere in the program, as specified 
by that statement's label address, entered ( not in quotes) as 
the operand of the JUMP statement. 

Statement JUMP SASPARIL ; 

Result Processing breaks sequence and jumps to the 

statement whose label is SASPARIL. 
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MATCH or M 



Permits entry into the block of code 
which follows it only if the last pre- 
ceding SCAN or TEST has succeeded, i.e., 
if the current condition code is positive . As each such block 
is entered, the level of processing drops to the next lower 
level. This brings into play -a* new condition code which can 
be modified without affecting the conditions that enabled entry 
into that block. In the current implementation of DISCUS, each 
statement in the block is processed but not executed until an 
END statement (q.v.) is encountered at the same level at which 
"ignore mode" was initiated. Blocks may be nested to e. 
depth of 250. 

A MATCH statement may be suppressed after N executions by 
specifying N. The N-counter (hereinafter called the ”MFB- counter” 
is reset by FRAME (q.v.)* 



FAIL or F Permits entry into the block of coae 

which follows it only if the current 
condition code is negative . Otherwise , 
FAIL operates in exactly the same way as MATCH. 



BLOCK or B Permits entry into the block of code 

which follows it, regardless of current 
condition code setting. BLOCK serves 
to drop the level of processing one level. Looping may be 
limited in the same way as is done with MATCH and FAIL, by an 
"MFB-counter . ” 
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FEAME or FE 



The FRAME statement marks the beginning 
of a logical division of DISCUS code, 
and is usually labelled. It has no 
operand, and performs no overt processing. It does, however, 
reset all MATCH, FAIL, and BLOCK recursion counters ( ir MFB- 
counters”) to zero, serves as a point of reference for USE 
statements accessing it, and serves as a restart location, 

A lf frame” as referred to in this manual comprises all 
the coding beginning with a FE.AME statement and ending at the 
next FRAME statement in sequence. Normally a frame contains 

a. Instructional test (W) 

b. A question of requirement (W or W(ND)) 

c. Opportunity for student input (A) 

d. Program reactions (SC, T, S, M, B, J, U, S, E, W, etc.) 
In order for it to be meaningful as a conversational unit, 

it must contain at least (c) and some form of (d). 

NOTE or N The NOTE opcode causes its operand to be 

printed in the OBJECT listing. It is 
otherwise inert. In addition to pre- 
serving and drawing attention to programmers' memoranda, NOTE 
can be used as s, temporary replacement for other opcodes , when 
it is desired to deactivate a statement temporarily without 
actually removing it from the source or from the object module. 
This can be done very simply by encoding Nb ahead of the existing 
opcode . 

END or E This opcode terminates a block which 

was entered at its own level (through 
a MATCH, FAIL, or BLOCK statement). To 
emerge from a nested block structure, a separate END statement 
is required for each upward step, and the total number of END 
statements must equal, but not exceed, the sum of all MATCH, FAIL, 
and BLOCK statements associated with that structure. 
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USE or U 



The USE statement transfers control 
temporarily to one or more statements 
accessible through a label address 
specified in its operand* The scope of this instruction depends 
on the nature of the first statement encountered at the location 
addressed: 

a* If it is a FRAME statement (q.v.) the entire frame 

•will be executed, and as soon as the next FRAME state- 
ment is encountered processing -will return automatically 
to the point immediately after the USE statement which 
invoked it . 

b. If it is a MATCH, FAIL, or BLOCK statement, it will cause 
the entire block governed by that statement to be exe- 
cuted, and will return automatically as soon as it en- 
counters an END statement at the same level as the MATCH 5 
FAIL, or BLOCK statement by means of which it first 
entered the block. 

c. If it is any other kind of statement it will process 
that one statement and return. 
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JOB CONTROL LANGUAGE 
FOR COMPILING DISCUS 



In order to compile a DISCUS source 
program in either the UC (Berkeley) 
or UCLA systems 5 certain Job Control 
statements must precede and follow the source deck when it is 
read into the IBM/360. 




The following control c to the system implemented 

at Berkeley: 

1. //J589UJCM JOB (589^ , 5 ,200,100 ) >MEREDITH s MSGLEVEL=l,CLASS=L 

A standard J’QB card for IBM 360 running under OS/36O 
(version IT). 

2. // EXEC PGM=DISCUS 5 PARM= f S0RMGIN=(l 5 T2) ,TTRZ T 

An EXEC card specifying the normal production DISCUS 
compiler and PARMs for special functions (see Note 
#11 below). 

3. //STEPLIB DD DISP=SHR ,DSN=ILR .BATCHLIB 

A STEPLIB card defining the library in which the DISCUS 
compiler resides. 

k. //SYSPRINT DD SYSOUT=A,DCB=BLKSIZE=n (n is any integral multiple 
of 133) 

A SYSPRINT card specifying where the listing of the program 
as compiled is to be written. 
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5. //DISCUS DD DSN=ILR.NAVIG,DISP=( OLD, KEEP) , 

SPACE= ( TRK , ( 1 , 1 ) ) ,V0LUME=SER=ILR04 ,UNIT=231^ 

The data set in which the compiled DISCUS object code 
is to be placed for later execution. 

6. //SYSUDUMP DD SYS0UT=A,DCB=(RECFM=VBA,LRECL=125 ,BLKSIZE=882) 

For compiler or system error only. 

7. //SYS IN DD DATA 

A SYSIN card indicating that the DISCUS source program 
follows . 

8. Deck of source statements. 

9. /* 

Marks end of DISCUS source. 



10 . // 

Marks end of program. 

11. The FARM field may contain any combination of the following, 
in any order separated by commas (no blanks): 

a. S0RMGIN= (n.nn ) Sets the margins of the source card 
images , "n" being the number of the column on the 
punch card for starting the image (as low as l) and 
M nn ,T being the number of the column for ending the 
image (may be as high as 80). (if not specified, (l,80) 
is assumed. ) 

b. T TRZ Generates a table of correspondence between 
statement numbers and the actual direct access lo- 
cations (relative) of the statements as compiled. 

Both are printed alongside the statements in the 
object listing. The TTRZ number provides ready 
access to any statement through AUTHOR MODE (see 
PART V.) 

c. SNAP For system debugging only. 

d. STQP=st op character When the single byte stop- 

character is encountered in a source card image, pro- 
cessing continues at the beginning of the next card image. 

e. DEBUG For system debugging only. A listing of all 
DISCUS statements, with special flags, is produced. 

f . SYMBQLS=numb er The absolute maximum number of symbols 
for which utility space will be reserved is here spec- 
ified. If not specified, all the core storage in the 
program* s region will be used for symbol table stmrage-. 
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PART V - SYSTEM AUTHOR MODE 



DESCRIPTION System Author Mode, is a mode of oper- 

ation available at the student terminal 
by means of which a DISCUS user (in the 
sense of an author/instructor, programmer, editor, etc.) can 
artificially influence execution and can arbitrarily jump from 
one part of the program to another. It may be invoked by en- 
tering the special command //A=Y at the terminal. This command 
may be entered at a carat or, if there is none, in the top left 
hand corner of the screen. 



DISTINGUISHED FROM In Part III, as one of the subroutines 

PROCTOR AUTHOR MODE useful in the programmer’s repertoire, 

we suggested one which would permit a 
user to jump execution to another part of the program without 
using DISCUS System Author Mode. This, Proctor Author Mode, 
device is essentially custom-made for a particular instruction- 
al sequence, as it entails coding a SCAN command and a JUMP com- 
mand for every unique location (according to label address) to 
which one wishes to be able to jump. 

This has its advantages and disadvantages. 

On the one hand, Proctor Author Mode is a convenient way 
of getting around in the program wiihout worrying about the 
precise disc location of the object statements (the TTRZ num- 
ber). If the user makes a mistake in designating a label, he 
is so informed, rather than being transferred to some wrong 
point in the program. The labels can be directly keyed tc writ- 
ten text and to the author/instructor's outline, , nd of ccrnrse 
appear on all object listings opposite the f .atemsnts to vihich 
they are affixed, as well as in a separate alphabetical last 
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showing the numbers of all statements referring to them. 

On the other hand, in a program of any size, the work of 
encoding and punching the hundreds of SCAN and JUMP statements 
involved in a Proctor Author Mode routine is considerable, and 
the resulting code is good only for one specific set of labels. 
Moreover , it must be updated whenever the program itself is 
substantially changed. The processing of this routine is fairly 
expensive in terms of computer time: in the case of one of our 
CAI courses, having 297 labels accessible by this method, the 
IBM 360 /U 0 takes up to 23 seconds of real time to get to the 
last label on the list. 

But its most serious weakness is that it doesn’t reveal 
what is going on inside the program, in the way the System 
Author Mode does . Proctor Author Mode merely transfers from 
normal execution in one place to normal execution in another. 

DIAGNOSTIC DISPLAY An integral part of SYSTEM .--AUTHOR MODE 



a System Author Mode command from the terminal, and ads o when- 
ever an unexecutable statement occurs during processing- Ex- 
amples of both are shown on page l40 . 



is the diagnostic display which appears 
on the screen whenever invoked: through 



SYSTEM AUTHOR MODE 
COMMANDS 



The following SYSTEM AUTHQE MTDE commands 
are available to the user: 



/ /A=Y 



Enter author mode after eEmtion of 
each statement. 



Other author mode c pee no do not 



depend on //A=Y having first been entered. 



but when not under //A=Y processing will 
revert to normal processi n g an the first 
opportunity. After specifdcaldy invoking 
author mode through //A=Y, ur*o cresting 



remains in author mode untd— revoked. 



//A=N 



Turns off author mode. 



Suppresses all JUMP statements that 
would normally he executed. 

Reinstates the operation of JUMP statements. 

Causes processing to stop at the state- 
ment number specified (per OBJECT list- 
ing). May he pre-set at any time. 

//V=block numb erb offset (works only under //A=Y) 

Causes the contents of a character vari- 
able to be displayed. The user must speci- 
fy the block number and the offset in 
that block in order to retrieve the vari- 
able from the student data set. The in- 
formation describing the location can be 
found in the source listing. 

//F^TTfeRteZ This is the basic ’’jump” command in Sys- 

tem Author Mode. The "TTRZ" refers to the 
disc location of each statement, which 
differs by one ,? R f ’ from that indicated 
in that object listing. Thus if the user 
wants to go to the statement whose TTRZ 
as shown in the object listing is 1/6/30, 
he should input 

//F=lbTb30. 

The true location also differs by one 1! Z" 
from the TTRZ as shown in the diagnostic 
display. In case of doubt, use the number* 
as shown in the object listing and advance 
to the desired location through successr*'e 
interrupts . 



/ /J=N 
/ /J—Y 

//S=number 
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EXIT (Berkeley) 
END (UCLA) 



Exits from the program. The student data 
set is preserved, and a notation of the re- 
start location (last frame) is recorded. 



EDITING There currently is no dynamic editing 

facility within the DISCUS system. That 
is , one cannot change the OBJECT MODULE 
from the terminal unless such a facility is available outside 
DISCUS, i.e., in the time-sharing monitor which controls the 
overall operation. (UCLA's "URSA" monitor does provide this.) 

DISCUS DIAGNOSTIC SCREEN 



Typical 

Display 



REQUESTED AUTHOR MODE 

OPERATION STATM COND LEVEL TTRZ+1 

S T FAIL 1 0-1-8 



"ZAP" = 1 



Interpretation : 

The executor has just executed the 7th state- 
ment in the program -which is a SET statement. 
The condition code for current execution pur- 
poses is FAIL. Exe nu n i on is proceeding at 
level 2- The ^statement occupies disc storage 
position 0-1-7- U nd erneath the line of hy- 
phens Is* displayed .the operand of the state- 
ment in. question. 
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PART VI EXERCISES 



•page 



A. WRITE STATEMENTS AND ANSWER STATEMENTS 1^3 

B. SCAN STATEMENTS 1^7 

C. USE OF LOGICAL OPERATORS IN SCANS 151 

D. VARIABLES !53 

E. DECISIONS 160 
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HOW TO USE THIS CHAPTER 



Space is provided (either as a display screen or as a few 
blank lines) for you to write your answer to each question 
as you proceed through this section. 

For the most part, solutions to problems are provided 
on the lower part of the same page, below a broken line. You 
should cover everything below the broken line until you are 
ready to check your answers . 
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A 



WRITE statements and ANSWER statements. 



1. How will the following appear on the screen? (Assume a 27-character- 
per-line screen capacity. ) 

WRITE HER HUSBAND n S TO ALEPPO GONE . ; 
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2. How will this appear? Show location of cursor after execution. 



WRITE FOR '"MRS. CRUMLEY ’’ S" ' FRITTERS USE THE FOLLOWING 
INGREDIENTS /fefcfefcl EGG/fcfcfcfel’ / ' 2 CUP » 'PET* 1 MILK/ 
tefetete2LB. FLOUR/ //GOOD LUCK.; 




2 . 



FOR "MRS. CRUMLEY’S" 
FRITTERS USE THE FOLLOWING 
INGREDIENTS : 

1 EGG 

1/2 CUP 'PET' MILK 
2 LB . FLOUR 



GOOD LUCK. 
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3- How might the following display have been encoded? 



NO, IN ANSWERING "BURNHAM 
WOOD" YOU HAVE NOT CORRECTLY 
IDENTIFIED THE INVENTOR OF 
PYROGRAPHY . 




4. How would you add "the words "TRY AGAIN" to the above screen? 



3. WRITE NO, IN ANSWERING """ANSWER""" YOU HAVE NOT CORRECTLY 
IDENTIFIED THE INVENTOR OF PYROGRAPHY.; 



4. WRITE (ND) TRY AGAIN.; or W(ND) TRY AGAIN.; 
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5 . 



How vouia you encode the statement creating the following display? 
(Use b to indicate blanks.) 




6. What opcode might be useful for displaying long numbers of 

formulae, or to get the maximum number of words into a screen? 



5. WRITE TABLE OF ENGLISH GUN SIZES ' : ' /tetePOUNDERteteteteteDIA. (IN. )/ 

fete tetetetete /tetebte32btetetetetetetetete6. Il/tetetete2ltetetetetetetetetete5. 82/ 

bbbbl8bbbb¥febbbb5 . 29/fefefefel2febtetetetefetetefel+. 62 /btetetete 9 bbbbbbbbbbl+ . 20/ ; 



6. WRITE (NF ) ; or W(NF); 




B. 



SCAN STATEMENTS 



[A] Which of the following SCANs will intercept (i.e., match, 
or succeed with) the ANSWER field contents shown? 



SCAN statement 



ANSWER field 



1. M F 


SC 


BARE CHOIRS; 


— — 


2 . M F 


sc 


EXPOSTULATION REPLY; 


3. M F 


sc 


' EXPO' 'ON ' REPLY; 


— — 


k. M F 


sc 


'POSTU' REPLY; 




5. M F 


sc 


QUINQUIREME OF 



NINEVEH FROM DISTANT 
OPHIR ; 



6. M F SC QUIT; 



BAREtebfeCHOIRS 

REPLY AND EXPOSTULATION 

EXPLOSION REPLY 

YOUR EXPOSTULATION 
MERITS A REPLY. . . . 

QUINQUERIME OF NINEVEH 
FROM DISTANT OPHIR 



I'M TIRED AND HUNGRY AND 
I WANT TO QUIT!!! 



(solutions to [A] 1-6) 



1. Match. Intervening words and/or blanks do not affect the operation. 



2. Fail. Elements must be in the stated order. 



3. Fail. 



The literal - ' EXPO' 
"explosion." (However 



is distinctive enough to screen out 
, "exposition" would have matched. ) 



k. Match. The literal 'POSTU' , taken from the middle of the word^is 
more distinctive than would be a literal at either of the 
ends. Neither "explosion" nor "exposition" would have got 
through . 



5 . Fail . 



Difficult input ruined by single spelling error. A more 
selective tr*- Tould have been more practical, 

e.g. , SC ' Q0Ui. 3H ' DISTANT ’ OPH' ; 

Preceding, intervening, or following words and/or blanks 
do not affect the operation, nor do the three exclamation 

marks . 
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6. Match. 



([a] cont.) 



7. M F 


SC QUIT; 


I 'M NOT QUITE SURE 


8. M F 


SC T; 


THE STATEMENT IS TRUE 


9. M F 


SC ' T' ; 


THE STATEMENT IS TRUE 


10 . M F 


SC 'T ' ; 


THE STATEMENT IS TRUE 


(solutions 


to [A] 7-10) 




7. Fail. 


The SCAN demands 


a "blank after the "t" of "QUIT". 1 



match “both QUIT and QUITE the element should he specified 
as a literal: ! QUIT ! . 

8. Fail * Same problem. The SCAN demands a blank on both sides of 

the "t". 

9. Match,. Will match any answer containing a word beginning with T. 

In this case, it caught on TRUE. 

10. Match. Will match any answer containing a word ending with T. 

In this case, it caught on STATEMENT. 
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[Bj After displaying the question "Who was Horace Greeley?", suppose 
you want to intercept answers of the following sense: - "He was 
a newspaper publisher." Formulate a SCAN operand which would 
best suit this purpose. (Disregard possibility of negatives.) 



SC 



[C] Formulate a SCAN similar to the above, but with the added f-s. 
that it will succeed only if the answerer also mentions the 
(New Yorh) Tribune. 



SC 



[D] Formulate a SCAN which will ensure tnat ’he studen- uses a 
semi-colon somewhere in his reply. 



(solutions to [B] through [D]) 

[B] SC ' NEWSP ' ; 

[C] SC ' NEWSP' & ' TRIB' ; 

[D] SC ' 
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[E] Formulate a SCAH which will ensure the student’s nbsolnte 
accuracy in Inputting the Following: 

I t's not the ' eayy 'auls than Verts the 1 os sea ’ooves; it's the, 
1 ammer , r ammer, * ampler oF the l srd. l * ard b^vajrs ^ 



SC 



(s clntion to [E]) 

[El SC T IT 1 1 S BCT THE 1 , EAVY 1 'AULS THAT ' 'URTS TEE T "ZfjBSSES r OOVES; 

IT* *S THE r r AMMER , 1 'AMMER , 1 ’AMMER OF THE r t &HD 9 ’* ajff ? 1 IGHWAIEEL 

(Explanation: The lone single quotes at the be-dir; g -and 

end oF the string define the string as a literal, a- the 

semicolon and commas need not he separately enrloseu single 
quotes. This does not suffice For the apostrophes 5 , i^v. ever , 
because they are always regarded as on-off switcher? tc- literal* 
whenever they occur. The basic rule applies, that s single 
quote, in order to be treated as a literal musn lue ion ...sd, 
whether or not it is inside a literal string.) 
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c. 



USE OF LOGICAL OPERATORS IN SCANS 



lA] Which of the following would succeed? Which fail? 



SCAN statement 



ANSWER field 



H. M J 

2. M J 

3. M F 

■4„ M F 
5. J1 F 

6- M F 



SC FISH, FOWL, GOOD BED 
HERRING; 

SC FISH, FOWL, GOOD RED 
HERRING; 

SC FISH, FOWL, GOOD RED 
HERRING; 

SC DIAMONDS & EMERALDS & 
AMETHYSTS ; 

SC DIAMONDS & EMERALDS & 
AMETHYSTS ; 



SC SANDALWOOD & CEDARWOOD, 
AND SWEET WHITE WINE 



HAMILTON FISH 



FOWL AND FISH 



CERTAINLY NOT HERRING! 



A CARGO OF DIAMONDS 
AND EMERALDS 

DIAMONDS AND AMETHYSTS 
BUT ABSOLUTELY NO 
EMERALDS OR TOPAZES 

SANDALWOOD AND SWEET 
WHITE WINE 



(solutions to 


[A] 1-6) 


1* Match*, 


Succeeds on FISH. 


2.. Man-ch . 


Succeeds on FISH. Skips FOWL and GOOD RED HERRING 
suboperands . 


3- Fail, 


Only part of the third suboperand is present. 


4. Fail, 


AMETHYSTS is missing in the "and'^d suhoperand. 


5- Match. 


All three ,, and ,, ed suboperands are present. Permuted 
order is acceptahle, because ampersands are used in 
the SCAN statement. 


6. Match. 


Fails on the first "and'^d pair of suboperands, because 
CEDARWOOD is not present. Succeeds on third suboperand 
because AND SWEET WHITE WINE is present. Note that the 
coder may actually have been thinking of the commas as 
a comma rather than as an "or 11 , and failed to turn it 
into a literal with single quotes. 
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(Use of logical operators in SCANS., cent . ) 



7. M_E_ 


SC SifflDALWOOr & CEDaHWOCD 
AND SWWE'E WHITE WINE 


CEDAlRWOOD but no 
SAFCALWOOD 


J 

00 


SC _ 'liOT, ILLYRIA; 


THIS “3 ILLYRIA L-^JT’- 


9. M F 


GC JC~ CADIA. , “»N0T; 


TEZS IS ILLYRIA; _ADY 


10. M F 


SC TL LIBIA* I ILLYRIA; 


THIS IS ILLYRIA. -ADI 


11. M J 


SC 1 HOT & BREAD; 


MAN DOES NOT LIVE: 31 
H3EAD ALONE 


12. M F 


SC — j EAT & BREAD; 


yiMl DOES NOT LIVE HE 
BREAD ALONE 


13. M F 


SC BREAD & — lEAT, NOT; 


MOT DOES NOT EKT 
HEBAD ALONE 



(solutions to 
7. Match . 

8* Match. 

9 . Match . 

10. Match . 

11. Fall . 

12. Match. 

13 . Match. 



[a] 7-1*0 

Succeeds on the ,t and tt ed pair of sub ope rands . Inversion 
is acceptable because of the ampersand. 

NOT is not present, so the statement succeeds an the 
first sub operand. 

Fails on first submpersnd, goes on and succeeds an. 
second . 



Succeeds on first enbcperand, ships the seccndL 

NOT is present, so the first of the two "smiled suboperamds 
fails* therefore all fails., 

EAT Is not present; BREAD is. 

EAT present, therefore the. two "and^ed :sub op errands failL. 
NOT is present, so the third sub operand obtains match. 



=HI£EH 



D. 



~nr trie exercises in th._~ section, all character variables will be 
l^ael—ad CEARA (n umb er) : -and all arithmetic variables will be labellsd. 

j DDDX 1 ' number ) : . 

1 . Define CHARA0 in sncii away -that it has room for 95 characters. 



Define ADDOX0 in such away that it has room for 100,000. 



~~n c oca a statement pricing the following character string into 
THE CUEENT ENROLLMENT £ T UCLA ISte 



U, Encp ios a. statement ^rr. i^a^l rig the niiiriben 25^000 into ADDOX0. 



(scILut icons to [D] -r—1) 

h.. Eai?’: d{c ) 95 ; 

2. inDOXGh D(a) :. (. TSnsr e is no way to specify the maximum size 
zS sxl srithnseti- c variable) 

3. tig ’ t - 3HLAHA0" = 'EEL CURRENT ENR0LLMED3T AT UCLA ISb' ; 

U. EET "ADDOX0" = 250 OCT" (Don't use commas ) 
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(variables , rmt . ) 

5. Znco.cie a .statement that will concatenate the number in AEDOX0 to 
CH&RA0. 



6. How vcruli you display to the student the contents of* CHARA0 at this 
noinh? 



7. VI' at vculid appear on the screen? 



8, Another student signs up. Ho&r do you increment ADDOX0? 



9. How dc yon bring CHARA0 up to date? (Use additional variables 
as needed » ) 



ysoirtions- to LD] (5-9) 

5. SET "CEARA0" = "CHARA0" ™MBDCmS" ; 

6. WRITE "CH3ffiA0" ; 

7. THE OU HRENT ENROL'/^MEIJT AT TJCLA IE 25000* 

3. SET "iDDQ$" = "ADDOX0"" + 1; 

9. CHARAl: D(C) 3U ; 

SET " CHARAl ,f = M CHARA0' ,T « -(Only tie first 3U character of CHARA0 
are stored in CHARAl); 

SET n CHARA0" = "CHARAl" "AHDOX0" ; 




(Wariables, corrt. ) 



LO. As part of "tie sign-in procedure, you migjrt ask the student to 

type his last name, following which you ask him to type his first 
name and initial. How would you store this information in both 
straight and iE” earned forms? 

(Step 1 - storing first ANSWER field) 



(Step 2 - storing second ANSWER field) 



(assume character variables as necessary have been defined) 



You decide to create a separate list of students' lest names, and, 
in order to get as many as possible into a single variable , to save 
only the first seven characters of each. How might you arrange this 
(Feel free to define additional variables as needed.) 



(solutions to [D'l 10 and ll) 

10. (Step 1) 

SET "CHARA2" = "ANSWER" ; 

(Step 2 1 

SET " r- mut.fi R " = "ANSWER" ' ,’ "CHARA2" ; 

SET "CHARA2" = "CHARA2" ' ’ "ANSWER"; 

11. CHARAU: D(C) T; 

CHARA5: D(C) 255; 

S "CHARAU" = "ANSWER"; 

S "CHARA5" = "CHARA5" ' "CHARAU"; 



(Variables, cont.) 



12. If 1 all the names are at least seven characters long, how many 
can be stuffed into the variable, assuming one blank is left 
between each seven character name? 



13. How can you find out if a new student has a name identical with 
someone already on the list? 

To begin: 

W WRITS YOUR LAST NAME, PLEASE.; 

A; 



lU. Place the number 1.44 into ADD0X2, and the number 37 into ADD0X3. 



(solutions to [D] 12-l4) 



12. 31 

255 / (1+7) 



13. W TYPE YOUR LAST NAME, PLEASE.; 



A; 

S "CHARA4" = "ANSWER"; 
S "ANSWER" = "CHARA5"; 
SC "CHARAV; 



l4. 




MATCH will occur here if the new name is identical to one of the 
old names . 

S "ADD0X2" = 144 

S "ADD0X3" =37; 



(Variables , cont . ) 

15. Place the mean of ADD0X2 and ADD0X3 into ADDOXU. 



ADDOXU will contain 



(solution to [D] 15) 

15. S "ADDOXU" = "ADD 0X2" + "ADD0X3" / 2; 

ADDOXU will contain 90. (lUU + 37/2 [note truncation] ) 
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(variables , cont . ) 



1 6. Suppose you want the student to construct and solve a problem 

in cubic measurement, which the program would check for accuracy. 
Five inputs are invo-ived. Fill in the blank items. (Solution on 
next page . ) 

W WHAT LINEAR MEASURE WILL YOU USE? ; 



A; 



s 

W HOW WIDE IS THE OBJECT YOU HAVE MEASURED? ; 



A; 

s ; ; 

W HOW LONG IS IT-?; 

A; 

s ; 

W HOW HIGH IS IT? ; 

A; 

s ; 

s ; 

W HOW MANY CUBIC DO YOU GET?; 

A; 

s ; 

SC "ADDOX 
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(Variables, cont.) 



(solution to [d] 16 ) 

16. W WHAT LINEAR MEASURE WILL YOU USE; 

A; 

S "CHARA6" = "ANSWER"; 

W HOW WIDE IS THE OBJECT YOU HAVE MEASURED?; 

A; 

S "ADD0X5” = "ANSWER"; 

W HOW LONG IS IT?; 

A; 

S "ADD0X6" = "ANSWER"; 

W HOW HIGH IS IT? ; 

A; 

S "ADDOX7" = "ANSWER"; 

S "ADDOX8" = "ADDOX5" * "ADDOX6" * "ADD0X7" ; 

W HOW MANY CUBIC "CHARA6" DO YOU GET? 

SC "ADDOX8" ; 

(If a match is obtained with .this SCAN, the following statement 
might be executed: ) 

W CORRECT. ; 

If not, the following: 

W THAT ' ' S ODD. I GET "ADD0X8" CUBIC "CHARA6" .; 
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E. 



DECISIONS 



The second group of exercises dealt with one form of decision 
making statement: the SCAN statement. 

The other decision making statement is the TEST statement. TEST 
is used for comparing all of the contents of one variable with all of 
the contents of another. It can be used for the comparison of both 
character and arithmetic variables. 

The following DISCUS rules are worth reviewing before starting 
the exercises in this group: 



1- TESTS and SCANS may be performed at any point in the program. 

2. The two items to be compared in a TEST are always explicitly 
stated. 

3. A SCAN always compares its operand with the current ANSWER 
field. 

4 . The result of a TEST or of a SCAN is always match or fail, 
(success or non-success), 

5. This result sets a condition code in the computer, which is 
tested by subsequent MATCH or FAIL statements. 

6. MATCH and FAIL statements concern themselves only with the 
preceding TEST (or SCAN) on the same level. 

7. A MATCH statement at a given level passes execution to the next 
statement if (and only if) the condition code indicates success . 
Otherwise it passes control to the statement following the 

next END statement on its own level. 

8. A FAIL statement is precisely the same as a MATCH statement 
except that execution proceeds to the next sequential statement 
if the condition code indicates f ail ■ 



O 




Problems : 

1. What would the following routine decide: What action(s) would 

ensue? 

W WHAT FITTINGS ARE USUALLY ASSOCIATED WITH PINTLESS?; 

A; 

SC GUDGEONS; 

M; 

W CORRECT; 

S. "NAUTICA" = "NAUTICA" + 1; (assume NAUTICA previously defined 

as an arithmetic variable) 

E; 

F; 

W I ' ' M AFRAID YOU DIDN ' ' T STUDY CHAPTER k . ; 

E; 



X. The routine would decide whether the student has used the word 
"gudgeons" in his reply. Action, if so, would he to display 
"Correct" and to increment an arithmetic variable which had been 
defined and labelled NAUTICA. Action, if not so, would be to 
display the words "I'm agraid you didn't study chapter 4. 




(Decisions, cont.) 



2. What would the following routine decide, and what action(s) 
would ensue? 

W THE THREE MAJOR TYPES OF FILM USED IN MICROGRAPHY 



HAWKEN: A; 

SC SILVER & DIAZO & VESCICULAR: 

M; 

W GOOD. YOU REMEMBERED ALL THREE. ; 

JUMP BAR; 

E; 

SC SILVER & DIAZO, SILVER & VESCICULAR, DIAZO & VESCICULAR; 

M; 

W SILVER HALIDE, DIAZO, AND VESCICULAR. ; 

J BAR; 

E; 

SC SILVER; 

M; 

W SILVER HALIDE IS RIGHT. THE OTHER TWO ARE DIAZC iJID VESCICULAR 
J BAR; 

E; 

SC DIAZO; 

M; 

W DIAZO IS RIGHT. THE OTHER TWO ARE SILVER HALIDE AND VESCICULAR 
J BAR; 

E; 

SC VESCICULAR; 

M; 
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W VESCICULAR IS RIGHT. THE OTHER TWO ARE SILVER HALIDE AND DIAZO.:. 



J BAR; 



E; 

F; 

W ONE OF THEM USES A PHOTOSENSITIVE METALLIC SALT EMULSION/ 
ONE OF THEM USES A PHOTOSENSITIVE DYE/ 

ONE OF THEM USES BUBBIiES /// TRY AGAIN . ; 

J HAWKEN; 

E; 

BAR: W WE WILL NOW SING HYMN NUMBER 35; 



The form of "verbal flowchart" furnished on the page which follows is 
useful for this kind of exercise. 
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TOHESHSET 



FRAME LABEL: 
Test : 

( ) Whether 



( ) Whether 



( ) Whether 



( ) Whether 



( ) Whether 



( ) Whether 



O 
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If yes 9 

If not, 

If yes , 

If not , 

If yes , 

If not , 

If yes , 

If not, 

If yes , 

If not, 

If yes , 

If not , 

_ If yes , 
If not, 
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( ) Whether 



worksheet: 



( De ei s ions , coni: , ) 

( scZTstion to [E" 2) 
ERMME LABEL: 



Test : 

' 1 ) Whether 





student, 


inputs 


all 3 


If 


yes. 


Display "Good, etc."; 














Jump to BAR 










If 


not , 


Go to next scan (2) 


. 2 ) 


Whether 














student 


inputs 


any 2 


If 


yes. 


Display complete answer; 














Jump to BAR 










If 


not , 


Go to next scan (3) 


(3) 


Whether 














student 


inputs 


"silver" only 


If 


yes. 


"Silver is right ... exc . TT . 














Jump to BAR 










If 


not , 


(^) 


(k) 


Whether 














student 


input s 


"diazo" only 


If 


yes. 


"Diazo is right ... etc . " . 














Jump to BAR 










If 


not , 


( 5 ) 


(5) 


Whether 














student 


inputs 


Vescicular" only 


If 


yes. 


"Vescicular is right .. .etc . 














Jump to BAR 










If 


not , 


(6) 


(6) 


Whether 














student 


input was unrecognized 


If 


yes. 


Display hint; Jump back to 














location of ANSWER statement. 










If 


not , 


(not applicable in this case.) 


( ) 


Whether 






If 


yes. 





If not,. 




- 165 - 

MB 



( 



The m e-xt “hree problems deiJL with this same example* 



3. Bracket the MATCH and FAIL blocks in the coded 11 source 11 program, 
as in this example: 

— M; 

W GOOr . YOU REMEMBERED ALL THREE. ; 

J BAR; 

i_ E; 

Does the number of ENT op coles equal the sum of MATCH and FAIL 
opcodes? 



Assuming that the sequence begins at condition code level 1, 
indicate the condition code level applying to each block. 



U. Was the last block - the FAIL block - really necessary as such? 



(solutions to [e] 3-U) 

3. The number of END opcodes (6) equals the sum of MATCH (5) and 
FAIL (l) opcodes. 

Condition level 2 is in effect in all blocks , since none of them 
are nested. 

U. No. The last entry on your decision worksheet should indicate 
this. The WRITE statement and the JUMP back to the ANSWER, 
statement will invariably operate whenever execution reaches 
them. Execution can reach them only if none of the preceding 
MATCH blocks has been successfully entered. 

FAIL block should be used principally to identify a class of 
failure, rather than total failure. This implies that one or 
more general "cleanup’ 1 statements is often needed before pro- 
ceeding to the next question. 



How might you imprcye the scan for "vescicular" 3 assumi ng that 
accurate spelling fe not a prime requisite here? 



(solution to [ E I 5) 

5. Probably ’’vesdcular' would be misspelled oftenest as 

vesicular 
vesiouller 
vesiculer 
vesciculler 
ves cicullar 



vesciculer 

So the most vulnerable letters are those underlined below: 

VESCIC UIiAR 

These can be "forgiven" by encoding the word as 3 literal 
strings or required elements 

1 VES T f ICU' 1 R f 
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(Decisions, cont. ) 



Note: the sequence of code of question 2 (page l62) may be written 
so that the scanning and writing functions are separated, 
as follows : 



W THE THREE MAJOR TYPES OF FILM USED IN MICROGRAPHY ARE 



S "EMU" = 0; 

HAWKEN: A; 

SC SILVER, DIAZO, VESCICULAR; 

1 M; 

SC SILVER; 

2 M; 

S "EMU" => "EMU" + 1; 

E; 

SC DIAZO; 

3 M; 

S "EMU" = "EMU" + 2; 

E; 

SC VESCICULAR; 

U M; 

S "EMU" = "EMU" + U; 

-m . 

Jii, 

T "EMU" = 7; 

5 M; 

W GOOD, YOU REMEMBERED ALL THREE; 
E; 

T "EMU" = 6; 
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(Decisions, cont.) 



6 M; 

W "DIA" AND "VES" ARE CORRECT. THE THIRD ONE IS "SIL" 
E; 

T "EMU" = 5; 

7 M; 

W "SIL" AND "VES" ARE CORRECT. THE THIRD ONE IS "DIA" 
E; 

T "EMU" = 3; 

8 M; 

W "SIL" AND "DIA" ARE CORRECT. THE THIRD ONE IS "VES" 
E; 

T "EMU" = 1-; 

9 M; 

W "SIL" IS RIGHT. THE OTHER TWO ARE "DIA" AND "VES"; 
E; 

T "EMU" = 2 

10 M; 

W "DIA" IS RIGHT. THE OTHER TWO ARE "SIL" AND "VES"; 
E; 

T "EMU" = k-. 
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(decisions , cont.) 



11 M; 

W "VES" IS RIGHT. THE OTHER TWO ARE "SIL ,f AND f, DIA" ; 

E; 

J BAR; 

E; 

W ONE OF THEM etc TRY AGAIN . ; 

J HAWKEN ; 

BAR ======== 

The above routine combines effective control with economy of means, 
besides lending itself to further extension. Note that it enabled 
us to improve on the earlier ,T shotgun 1T response to answers containing 
only two out of the three terms sought. 





- 170 - 



